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本 书 是 对 lvan.Morgillo 所 写 一 书 的 中 文 翻译 版 本 ， 仅 供 交 流 学 习 使 用 ， 严 禁 商 业 用 
途 。 另 外 推荐 一 本 姊妹 篇 《Learning Reactive Programming) ° 


e 《RxJava Essentials) 翻译 中 文 版 电子 书 


e 《RxJava Essentials》 一 书 作 者 代码 样 例 


本 书 内 容 有 


1.RX-from .NET to RxJava 


本 章 带 你 进入 reactive 的 世界 。 我 们 会 比较 reactive 方法 和 传统 方法 ， 进 而 探索 
它们 之 间 的 相似 和 不 同 的 地 方 。 


2.Why Observables? 


被 观察 者 是 什么 ， 以 及 被 观察 者 如 何 与 迭代 联系 到 一 起 的 。 


3.Hello Reactive World 


本 章 会 利用 我 们 所 学 的 知识 来 创建 第 一 个 reactive Android M o 


4.Filtering Observables 


本 章 我 们 会 研究 Observable 序 列 的 本 质 :filtering. 我 们 也 将 学 到 如 何 从 一 个 发 出 
的 Observable 中 选取 我 们 想 要 的 值 ， 如 何 获 得 一 个 有 限 的 数值 ， 如 何 处 理 溢出 
的 场景 ， 以 及 更 多 有 用 的 技巧 。 

5.Transforming Observables 


本 章 将 讲述 如 何 通 过 变换 Observable 序 列 来 创建 出 我 们 所 需要 的 序列 。 


6.Combining Observables 


本 章 将 研究 与 函数 结合 ， 同 时 也 会 学 到 当 创建 我 们 想 要 的 Observable 时 又 如 何 
与 多 个 Observable 协 同 工 作 。 


7.Schedulers-Defeating the Android MainThread 
Issue 


本 章 将 介绍 如 何 使 用 RxJava Schedulers 来 处 理 多 线程 和 并 发 编程 。 我 们 也 将 
用 reactive 的 方式 来 创建 网 络 操 作 、 内 存 访 问 、 耗 时 处 理 。 


8.REST in peace-RxJava and Retrofit 


本 章 教会 你 如 何 让 Square 公司 的 Retrofit 和 RxJava 结 合 来 一 起 使 用 ， 来 创建 一 
个 更 高 效 的 REST 客 户 端 程序 。 


学 习 这 本 书 你 需要 做 的 : 
为 了 能 够 运行 书 中 的 例子 ， 你 需要 一 个 标准 的 Android 开 发 环境 : 


e Android Studio * Intellij IDEA 


e Android SDK 
e Java SDK 


作为 一 个 纯粹 的 Java 开 发 者 ， 当 你 接触 RxJava 时 ， 很 明显 你 需要 一 个 你 喜欢 Java 
编辑 器 和 一 个 标准 的 Java JDK 环境 。 这 本 书 中 的 一 些 图 表 来 自 
http://rxmarbles.com 和 http://reactivex.io ° 


这 本 书 适合 哪 些 人 看 


如 果 你 是 一 名 有 经 验 的 Java 开 发 者 ，reactive 编 程 将 会 在 后 端 系统 中 给 你 一 种 新 的 
学 习 扩 展 和 并 发 的 方式 ， 而 这 不 需要 更 换 开 发 语言 。 这 本 书 将 帮助 你 学 习 RxJava 的 
核心 方面 ,也 能 帮助 你 克服 Android 平 台 局 限 性 从 而 创建 一 个 基于 事件 驱动 的 ， 响 应 
式 的 ， 流 畅 体 验 的 Android 应 用 。 


一 些 约定 
在 这 本 书 中 ， 你 会 发 现 许多 用 来 区 分 不 同 信息 的 文本 样式 ， 这 列举 这 些 样式 的 一 些 
例子 和 对 他 们 释义 的 说 明 。 


以 下 列举 了 些 文本 中 的 代码 、 数 据 库 表 名 、 文 件 夹 名 、 文 件 名 、 文 件 扩展 名 、 路 径 
名 、 伪 造 的 URL、 用 户 输入 、Twitter handles : “正如 你 看 到 的 那样 : zip() 有 三 个 参 
a : 两 个 Observable 和 一 个 Func2” 


如 下 面 的 一 块 代码 : 


public Observable<List<User>> getMostPopularSOusers(int howmany ) 
{ 
return mStackExchangeService 
.getMostPopularSOusers(howmany ) 
.map(UsersResponse: :getUsers) 
. subscribeOn(Schedulers.io()) 
.observeOn(AndroidSchedulers.mainThread()); 


当 我 们 想 对 代码 块 的 某 一 部 分 引起 你 的 注意 时 ， 会 在 对 应 的 那 一 行 或 列 设置 为 粗 体 


public Observable<List<User>> getMostPopularSOusers(int howmany) 
{ 
return mStackExchangeService 
.getMostPopularSOusers(howmany ) 
-map(UsersResponse: :getUsers)  //#i £4] ol wT 


. subscribeOn(Schedulers.io()) 
.observeOn(AndroidSchedulers.mainThread()); 


} 
| 


新 的 项 目 和 重要 的 词语 都 会 以 粗 体 显示 。 你 在 屏幕 看 到 的 字 ， 例 如 在 菜单 或 者 对 话 
框 ， 会 以 类 似 这 样 的 形式 出 现在 文本 中 : We will just need a fancy progress bar 
and a DOWNLOAD button. 


Note 
类 似 这 样 的 是 警告 或 者 出 现在 框 中 的 重要 提示 。 


Tip 类 似 这 样 的 是 提示 和 技巧 


读者 反馈 


发 送 邮件 到 feedback@packtpub.com 在 你 的 邮件 主题 中 要 提 到 书 的 标题 。 


如 果 你 有 擅长 的 话题 并 且 你 对 写作 感 兴趣 或 者 想 出 书 的 话 ， 可 以 看 我 们 作者 指 
南 : http://www.packtpub.com/authors 


下 载 样 例 代 码 
你 可 以 从 你 在 http://www.packtpub.com 的 账户 中 下 载 所 有 你 购买 Packt 出 版 的 图 书 


的 样 例 代码 ， 如 果 你 从 别处 购买 这 本 书 的 话 ， 你 可 以 访 
e] : http://www.packtpub.com/support 注册 并 将 文件 用 附件 直接 发 给 你 。 


版 权 说 明 


RxJava Essentials 中 文 翻 译 版 仅 供 交流 学 习 使 用 ， 严 禁 商 业 用 途 。 转 载 请 联系 作 
者 yuxingxin ° 


RX - 从 .NET 到 RxJava 


响应 式 编程 是 一 种 基于 异步 数据 流 概念 的 编程 模式 。 数 据 流 就 像 一 条 河 : 它 可 以 被 
观测 ， 被 过 渡 ， 被 操作 ， 或 者 为 新 的 消费 者 与 另外 一 条 流 合并 为 一 条 新 的 流 。 


响应 式 编程 的 一 个 关键 概念 是 事件 。 事 件 可 以 被 等 待 ， 可 以 触发 过 程 ， 也 可 以 触发 
其 它 事 件 。 事 件 是 唯一 的 以 合适 的 方式 将 我 们 的 现实 世界 映射 到 我 们 的 软件 中 : 如 
果 屋 里 太 热 了 我 们 就 打开 一 局 窗户 。 同 样 的 ， 当 我 们 更 改 电 子 表 《变化 的 传播 ) 中 
的 一 些 数值 时 ， 我 们 需要 更 新 整个 表格 或 者 我 们 的 机 器 人 碰 到 墙 时 会 转弯 (响应 事 
Gag 

今天 ， 响 应 式 编程 最 通用 的 一 个 场景 是 Ul : 我 们 的 移动 App 必 须 做 出 对 网 络 调用 、 
用 户 触 摸 输入 和 系统 弹 框 的 响应 。 在 这 个 世界 上 ， 软 件 之 所 以 是 事件 驱动 并 响应 的 
是 因为 现实 生活 也 是 如 此 。 


微软 响应 式 扩展 


函数 响应 式 编程 是 一 个 来 自 90 年 代 后 期 受 微软 的 一 名 计算 机 科学 家 Erik Meijers £ 
的 思想 ， 用 来 设计 和 开发 微软 的 Rx 库 。 


Rx 是 微软 .NET 的 一 个 响应 式 扩 展 。Rx 借 助 可 观测 的 序列 提供 一 种 简单 的 方式 来 创 
建 异步 的 ， 基 于 事件 驱动 的 程序 。 开 发 者 可 以 使 用 Observables 模 拟 异 步 数 据 流 ， 
使 用 LINQ 语 法 查询 Dbservables， 并 且 很 容易 管理 调度 器 的 并 发 。 


es 

我 们 不 能 假装 作用 户 不 关注 或 者 是 不 抱怨 它 而 一 味 的 等 待 函 数 的 返回 结果 ， 网 络 调 
用 ， 或 者 数据 库 查询 的 返回 结果 。 我 们 时 刻 都 在 等 待 某 些 东西 ， 这 就 让 我 们 失去 了 
并 行 处 理 其 他 事情 的 机 会 ， 提 供 更 好 的 用 户 体验 ， 让 我 们 的 软件 免 受 顺序 链 的 影 

响 ， 而 阻塞 编程 。 


下 表 列 出 的 与 .NET 枚 举 相 关 的 .NET Observable 


.NET Observable 一 个 返回 值 多 个 返回 值 
Pull/Synchronous/Interactive T IEnumerable<T> 
Push/Asynchronous/Reactive Task<T> IObservable<T> 


haer aa 个 问题 逆转 了 : 取而代之 的 是 不 再 等 待 结果 ， 开 发 者 只 是 简单 的 请 求 
结果 ， 而 当 它 返回 时 得 到 一 个 通知 即 可 。 开 发 者 对 即将 发 生 的 事件 提供 一 个 清晰 的 
wae 。 对 于 每 一 个 事件 ， 开 发 者 都 作出 相应 的 响应 ; 例如 ， 用 户 被 要 求 登 录 的 时 
， 提交 一 个 携带 他 的 用 户 名 和 密码 的 表单 。 应 用 程序 执行 登录 的 网 络 请 求 ， 接 下 
: 


e 显示 一 个 成 功 的 信息 ， 并 保存 用 户 的 个 人 信息 
e 显示 一 个 错误 的 信息 
正如 你 用 push 方 法 所 看 到 的 ， 开 发 者 不 T 待 结果 。 而 是 在 结 回 时 通知 他 。 


在 这 期 间 ， 他 可 以 做 他 想 做 的 任何 事情 


e 显示 一 个 进度 对 话 框 
e 为 下 次 登录 保存 用 户 名 和 密码 
e 预 加 载 一 些 他 认为 登录 成 功 后 需要 耗 时 处 理 的 事情 


微软 响应 式 扩展 
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+ E] Java: - Netflix RxJava 


Netflix 在 2012 年 开始 意识 到 他 们 的 架构 要 满足 他 们 庞大 的 用 户 群 体 已 经 变 得 步履 维 
艰 。 因 此 他 们 决定 重新 设计 架构 来 减少 REST 调 用 的 次 数 。 取 代 几 十 次 的 REST 调 
用 ， 而 是 让 客户 端 自己 处 理 需 要 的 数据 ， 他 们 决定 基于 客户 端 需求 创建 一 个 专门 优 
化 过 的 REST 调 用 。 


为 了 实现 这 一 目标 ， 他 们 决定 尝试 响应 式 ， 开 始 将 .NET Rx 迁 移 到 JVM 上 面 。 他 们 
不 想 只 基于 Java 语 言 ; 而 是 整个 JVM， 从 而 有 可 能 为 市 场 上 的 每 一 种 基于 JVM 的 语 
言 : 如 Java、Clojure、Groovy、Scala 等 等 提供 一 种 新 的 工具 。 


2013 年 二 月 份 ,Ben Christensen 和 Jafar Husain 发 在 Netflix 技 术 博 客 的 一 篇 文章 第 
一 次 向 世界 展示 了 RxJava。 


主要 特点 有 : 


© 易于 并 发 从 而 更 好 的 利用 服务 器 的 能 力 。 
e 易于 有 条 件 的 异步 执行 。 

o 一 种 更 好 的 方式 来 避免 回调 地 狱 。 

e 一 种 响应 式 方法 。 


正如 .NET,RxJava Observable 是 push 迭代 的 等 价 体 ， 即 pull。pull 方 法 是 阻塞 并 等 
待 的 方法 : 消费 者 从 源头 pull 值 ， 并 阻塞 线程 直到 生产 者 提供 新 的 值 。 


push 方 法 作用 于 订阅 和 响应 : 消费 者 订阅 新 值 的 发 射 ， 当 它们 可 用 时 生产 者 push 这 
些 新 值 并 通知 消费 者 。 在 这 一 点 上 ， 消 费 者 消费 了 它们 。push 方 法 很 明显 更 灵活 ， 
因为 从 逻辑 和 实践 的 观点 来 看 ， 开 发 者 只 需 忽略 他 需要 的 数据 是 来 自 同 步 还 是 异 
步 ; 他 的 代码 将 仍然 起 作用 。 


RxJava 的 与 众 不 同 之 处 


从 纯 Java 的 观点 看 ，RxJava Observable 类 源 自 于 经 典 的 Gang Of Four 的 观察 者 模 
Ro 


它 添加 了 三 个 缺少 的 功能 : 
o 生产 者 在 没有 更 多 数据 可 用 时 能 够 发 出 信号 通知 : onCompleted() 事 件 。 


o 生产 者 在 发 生 错误 时 能 够 发 出 信号 通知 : onError() 事 件 。 
e RxJava Observables 能 够 组 合 而 不 是 齿 套 ， 从 而 避免 开发 者 陷入 回调 地 狱 。 


Observables 和 lterables 共 用 一 个 相似 的 API : 我 们 在 lterable 可 以 执行 的 许多 操作 也 
都 同样 可 以 在 Observables 上 执行 。 当 然 ， 由 于 Observables 流 的 本 质 ， 没 有 如 
lterable.remove() 这 样 相 应 的 方法 。 


Pattern 一 个 返回 值 多 个 返回 值 
Synchronous T getData() Iterable<T> 
Asynchronous Future<T> getData() Observable<T> getData() 


从 语义 的 角度 来 看 ，RxJava 就 是 .NET Rx。 从 语法 的 角度 来 看 ，Netflix 考 虑 到 了 对 
应 每 个 Rx 方 法 ,保留 了 Java 代 码 规范 和 基本 的 模式 。 
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本 章 中 ， 我 们 初步 探索 了 响应 式 的 世界 。 从 微软 的 .NET 到 Netflix 的 RxJava， 我 们 了 
解 了 Rx 是 如 何 诞生 的 ， 我 们 也 了 解 到 传统 的 方法 与 响应 式 方法 相 比 之 间 的 相似 和 不 
同 o 

下 一 章 ， 我 们 将 学 习 到 Observables 是 什么 ， 以 及 如 何 创建 它 并 把 响应 式 编程 应 用 
到 我 们 的 日 常 编码 中 去 。 


为 什么 是 Observables? 


面向 对 和 象 的 架构 中 ， 开 发 者 致力 于 创建 一 组 解 褐 的 实体 。 这 样 的 话 ， 实 体 就 可 以 
E Ee nico 复 用 和 维护 。 设 计 这 种 系统 就 带 来 一 个 
RENDA: 维护 相关 对 象 之 间 的 统一 。 


在 Smalltalk MVC 架 构 中 ， 创 建 模式 的 第 一 个 例子 就 是 用 来 解决 这 个 问题 的 。 用 户 
界面 框架 提供 一 种 途径 使 Ul 元 素 与 包含 数据 的 实体 对 象 相 分 离 ， 并 且 同 时 ， 它 提供 
一 种 灵活 的 方法 来 保持 它们 之 问 的 同步 





在 这 本 畅销 的 四 人 组 编写 的 《设计 模式 可 复 用 面向 对 象 软 件 的 基础 》 一 书 中 ， 
观察 者 模式 是 最 有 名 的 设计 模式 之 一 。 它 是 一 种 行为 模式 并 提供 一 种 以 一 对 多 的 依 
赖 来 绑 定 对 象 的 方法 : 即 当 一 个 对 象 发 生变 化 时 ， 依 赖 它 的 所 有 对 象 都 会 被 通知 并 
且 会 自动 更 新 。 


在 本 章 中 ， 我 们 将 会 对 观察 者 模式 有 一 个 概述 ， 它 是 如 何 实 现 的 以 及 如 何 用 RxJava 
来 扩展 ，Observable 是 什么 ， 以 及 Observables 如 何 与 lterables 相 关联 。 


在 今天 ， 观 察 者 模式 是 出 现 的 最 常用 的 软件 设计 模式 之 一 。 它 基于 subject 这 个 概 
念 。subject 是 一 种 特殊 对 象 ， 当 它 改 变 时 ， 那 些 由 它 保存 的 一 系列 对 象 将 会 得 到 通 
知 。 而 这 一 系列 对 象 被 称 作 Observers, 它 们 会 对 外 暴 漏 了 一 个 通知 方法 , 当 subject 状 
态 发 生变 化 时 会 调用 的 这 个 方法 。 


在 上 一 章 中 ， 我 们 看 到 了 电子 表单 的 例子 。 现 在 我 们 可 以 展开 这 个 例子 讲 ， 展 示 一 
个 更 复杂 的 场景 。 让 我 们 考虑 这 样 一 个 填 着 账户 数据 的 电子 表单 。 我 们 可 以 把 这 些 
数据 比 作 一 张 表 ， 或 者 是 3D 柱 状 图 ， 或 者 是 饼 状 图 。 它 们 中 每 一 个 代表 的 意义 都 取 
决 于 同一 组 要 展示 的 数据 。 每 一 个 都 是 一 个 观察 者 ， 都 依赖 于 那 一 个 subject， 维 护 


着 全 部 信息 。 


3D 柱 状 图 这 个 类 、 人 饼 状 图 类 、 表 这 个 类 以 及 维护 这 些 数据 的 类 是 完全 解 耦 的 : 它们 
彼此 相互 独立 复 用 ， 但 也 能 协同 工作 。 这 些 表示 类 彼此 不 清楚 对 方 ， 但 是 正如 它们 
所 做 的 : 它们 知道 在 哪 能 找到 它们 需要 展示 的 信息 ， 它 们 也 知道 一 旦 数据 发 生变 化 
就 通知 需要 更 新 数据 表示 的 那个 类 。 


这 有 一 张 图 描述 了 Subject/Observer 的 关系 是 怎样 的 一 对 多 的 关系 : 


+observerCollection 


+registerObserver (observer) 
+unregisterObserver (observer) 
+notifyObservers() 















< 







N 
notifyObservers() 
for observer in observerCollection 
call observer.notify() 





ConcreteObserverB 


+notify() 





ConcreteObserverA 


+notify() 

















上 面 这 张 图 展示 了 一 个 Subject 为 3 个 Observers 提 供 服务 。 很 明显 ， 没 有 理由 去 限 
制 Observers 的 数量 : 如 果 有 需要 ， 一 个 Subject 可 以 有 无 限 多 个 Observers, 当 
Subject 状 态 发 生变 化 时 ， 这 些 Observers 中 的 每 一 个 都 会 收 到 通知 。 
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e 51; 

复 用 它们 时 。 
e 当 一 个 变化 的 对 象 通知 那些 与 它 自身 变化 相关 联 的 未 知 数量 的 对 象 时 。 
© 当 一 个 变化 的 对 象 通知 那些 无 需 推断 具体 是 谁 的 对 象 时 。 


你 的 架构 有 两 个 实体 类 ， 一 个 依赖 另 一 个 ， 你 想 让 它们 互 不 影响 或 者 是 独立 


RxJava LX HALA E 


在 RxJava 的 世界 里 ， 我 们 有 四 种 角色 : 


e Observable 
e Observer 
e Subscriber 
e Subjects 


Observables 和 Subjects 是 两 个 “生产 ?实体 ，Observers 和 Subscribers 是 两 个 “ 消 


Observable 


当 我 们 异步 执行 一 些 复 杂 的 事情 ，Java 提 供 了 传统 的 类 ， 例 如 Thread、Future、 
FutureTask、CompletableFuture 来 处 理 这 些 问 题 。 当 复杂 度 提 升 ， 这 些 方案 就 会 
变 得 麻烦 和 难以 维护 。 最 糟糕 的 是 ， 它 们 都 不 支持 链 式 调用 。 


RxJava Observables 被 设计 用 来 解决 这 些 问 题 。 它 们 灵活 ， 且 易于 使 用 ， 也 可 以 链 
式 调 用 ， 并 且 可 以 作用 于 单个 结果 程序 上 ， 更 有 甚 者 ， 也 可 以 作用 于 序列 上 。 无 论 
何 时 你 想 发 射 单个 标量 值 ， 或 者 一 连 串 值 ， 甚 至 是 无 穷 个 数值 流 ， 你 都 可 以 使 用 
Observable º 


Observable 的 生命 周期 包含 了 三 种 可 能 的 易于 与 lterable 生 命 周 期 事件 相 比 较 的 事 
件 ， 下 表 展 示 了 如 何 将 Observable async/push 与 lterable sync/pull 相 关联 起 来 。 


Event lterable(pull) Observable(push) 
检索 数据 T next() onNext(T) 
发 现 错 误 throws Exception onError(Throwable) 
完成 !hasNext () onCompleted() 


使 用 lterable 时 ， 消 费 者 从 生产 者 那里 以 同步 的 方式 得 到 值 ， 在 这 些 值得 到 之 前 线程 
处 于 阻塞 状态 。 相 反 ， 使 用 DObservable 时 ， 生 产 者 以 异步 的 方式 把 值 推 给 观察 者 ， 
无 论 何 时 ， 这 些 值 都 是 可 用 的 。 这 种 方法 之 所 以 更 灵活 是 因为 即便 值 是 同步 或 异步 
方式 到 达 ， 消 费 者 在 这 两 种 场景 都 可 以 根据 自己 的 需要 来 处 理 。 


为 了 更 好 地 复 用 lterable 接 口 ，RxJava Observable 类 扩展 了 GOF 观 察 者 模式 的 语 
义 。 引 入 了 两 个 新 的 接口 : 


e onCompleted() 即 通知 观察 者 Observable 没 有 更 多 的 数据 。 
e onError() 即 观 察 者 有 错误 出 现 了 。 


A Observables#- “4Observables 


从 发 射 物 的 角度 来 看 ， 有 两 种 不 同 的 Observables: 热 的 和 冷 的 。 一 个 " 热 "的 
a 创建 完 就 开始 发 射 数据 ， 因 此 所 有 后 续 订阅 它 的 观察 者 可 
从 序列 中 间 的 某 个 位 置 开 始 接受 数据 (有 一 些 数据 错过 了 ) 。 一 个 " 冷 "的 


Observable 会 一 直 等 待 ， 直 到 有 观察 者 订阅 它 才 开始 发 射 数 据 ， 因 此 这 个 观察 者 可 
以 确保 会 收 到 整个 数据 序 o 


创建 一 个 Dbservable 
在 接 下 来 的 小 节 中 将 讨论 Observables 提 供 的 两 种 创建 Observable 的 方法 。 


Observable.create() 


create() 方 法 使 开发 者 有 能 力 从 头 开始 创建 一 个 Dbservable。 它 需要 一 个 
OnSubscribe 对 象 ,这 个 对 象 继承 Action1, 当 观察 者 订阅 我 们 的 Observable 时 ， 它 作 
为 一 个 参数 传 入 并 执行 call() 有 函数。 


Observable.create(new Observable.OnSubscribe<Object>(){ 


@Override 

public void call(Subscriber<? super Object> subscriber) 
{ 

} 
}); 


pne A atit A subscriber & E HARE RAA EHO A RFe MRA WS o 1k 
我 们 看 一 个 “现实 世界 ?的 例子 


Observable<Integer> observableString = Observable.create(new Obs 
ervable.OnSubscribe<Integer>() { 
@Override 
public void call(Subscriber<? super Integer> observer) { 
OG (ane de =O as RA 
observer .onNext(i); 


} 


observer .onCompleted(); 


3); 


Subscription subscriptionPrint = observableString.subscribe(new 
Observer<Integer>() { 
@Override 
public void onCompleted() { 
System.out.println("Observable completed"); 


@Override 
public void onError(Throwable e) { 
System.out.println("Oh,no! Something wrong happened! "); 


@Override 
public void onNext(Integer item) { 
System.out.printin("Item is " + item); 


}); 


例子 故意 写 的 简单 ， 是 因为 即便 是 你 第 一 次 见 到 RxJava 的 操作 ， 我 想 让 你 明白 接 下 
来 要 发 生 什么 。 


我 们 创建 一 个 新 的 Observable<Integer> , 它 执 行 了 5 个 元 素 的 for 循 环 ， 一 个 接 一 
个 的 发 射 他 们 ， 最 后 完成 。 


另 一 方面 ， 我 们 订阅 了 Observable， 返 回 一 个 Subscription 。 一 旦 我 们 订阅 了 ， 我 
们 就 开始 接受 整数 ， 并 一 个 接 一 个 的 打印 出 它们 。 我 们 并 不 知道 要 接受 多 少 整数 。 
事实 上 ， 我 们 也 无 需 知道 是 因为 我 们 为 每 种 场景 都 提供 对 应 的 处 理 操作 : 


e 如 果 我 们 接收 到 了 整数 ， 那 么 就 打印 它 。 
o 如 果 序 列 结束 ， 我 们 就 打印 一 个 关闭 的 序列 信息 。 
o 如 果 错 误 发 生 了 ， 我 们 就 打印 一 个 错误 信息 。 


Observable.from() 


在 上 一 个 例子 中 ， 我 们 创建 了 一 个 整数 序列 并 一 个 一 个 的 发 射 它 们 。 假 如 我 们 已 经 
有 一 个 列表 呢 ? 我 们 是 不 是 可 以 不 用 for 循 环 而 也 可 以 一 个 接 一 个 的 发 射 它们 呢 ? 


在 下 面 的 例子 代码 中 ， 我 们 从 一 个 已 有 的 列表 中 创建 一 个 Dbservable 序 列 : 


List<Integer> items = new ArrayList<Integer>(); 
items.add(1); 

items.add(10); 

items.add(100); 

items.add(200); 


Observable<Integer> observableString = Observable.from(items); 
Subscription subscriptionPrint = observableString.subscribe(new 
Observer<Integer>() { 
@Override 
public void onCompleted() { 
System.out.println("Observable completed"); 


@Override 
public void onError(Throwable e) { 
System.out.println("Oh,no! Something wrong happened! "); 


@Override 
public void onNext(Integer item) { 
System.out.printin("Item is " + item); 


3); 


输出 的 结果 和 上 面 的 例子 绝对 是 一 样 的 。 


from() 创建 符 可 以 从 一 个 列表 /数组 来 创建 Observable, 并 一 个 接 一 个 的 从 列表 / 数 
组 中 发 射出 来 每 一 个 对 象 ， 或 者 也 可 以 从 Java Future 类 来 创建 Observable， 并 
发 射 Future 对 象 的 .get() 方法 返回 的 结果 值 。 传 入 Future 作为 参数 时 ， 我 们 
可 以 指定 一 个 超时 的 值 。Observable 将 等 待 来 自 Future 的 结果 ; 如 果 在 超时 之 前 
仍然 没有 结果 返回 ，Observable 将 会 触发 onError() 方法 通知 观察 者 有 错误 发 生 
T3 


Observable.just() 


toR RN CAAT ME Ah) Java ik > BIBI C4 EA —* Observable X aE 
ADR? 我 们 可 以 用 create() 方法 ， 正 如 我 们 先前 看 到 的 ， 或 者 我 们 也 可 以 像 下 
面 那 样 使 用 以 此 来 省 去 许多 模板 代码 : 


Observable<String> observableString = Observable. just (helloworld 
O); 


Subscription subscriptionPrint = observableString.subscribe(new 
Observer<String>() { 
@Override 
public void onCompleted() { 
System.out.println("Observable completed"); 


@Override 
public void onError(Throwable e) { 
System.out.println("Oh,no! Something wrong happened!"); 


@Override 
public void onNext(String message) { 
System.out.println(message); 


+); 


helloworld() 方法 比较 简单 ， 像 这 样 : 


private String helloworld(){ 
return "Hello World"; 


不 管 怎样 ， 它 可 以 是 我 们 想 要 的 任何 函数 。 在 刚才 的 例子 中 ， 我 们 一 旦 创建 了 
Observable > just() 执行 耻 数 ， 当 我 们 订阅 Observable 时 ， 它 就 会 发 射出 返回 
的 té o 


just() 方法 可 以 传 入 一 到 九 个 参数 ， 它 们 会 按照 传 入 的 参数 的 顺序 来 发 射 它 
们 。 just() 方法 也 可 以 接受 列表 或 数组 ， 就 像 from) 方法 ， 但 是 它 不 会 迭代 
列表 发 射 每 个 值 , 它 将 会 发 射 整个 列表 。 通 常 ， 当 我 们 想 发 射 一 组 已 经 定义 好 的 值 时 
会 用 到 它 。 但 是 如 果 我 们 的 通 数 不 是 时 变性 的 ， 我 们 可 以 用 just 来 创建 一 个 更 有 组 
织 性 和 可 测 性 的 代码 库 。 


最 后 注意 just() 创建 符 ， 它 发 射出 值 后 ，Observable 正 常 结束 ， 在 上 面 那 个 例子 
中 ， 我 们 会 在 控制 台 打 印 出 两 条 信息 : “Hello World”fr“Observable completed” ° 


Observable.empty(),Observable.never(), 和 
Observable.throw() 


当 我 们 需要 一 个 Observable 毫 无 理由 的 不 再 发 射 数 据 正常 结束 时 ， 我 们 可 以 使 

用 empty() 。 我 们 可 以 使 用 never() 创建 一 个 不 发 射 数据 并 且 也 永远 不 会 结束 
的 Observable。 我 们 也 可 以 使 用 throw() 创建 一 个 不 发 射 数据 并 且 以 错误 结束 的 
Observable º 


Subject = Observable + Observer 


subject 是 一 个 神奇 的 对 象 ， 它 可 以 是 一 个 Observable 同 时 也 可 以 是 一 个 
Observer : 它 作 为 连接 这 两 个 世界 的 一 座 桥梁 。 一 个 Subject 可 以 订阅 一 个 
Observable， 就 像 一 个 观察 者 ， 并 且 它 可 以 发 射 新 的 数据 ， 或 者 传递 它 接受 到 的 数 
据 ， 就 像 一 个 Observable。 很 明显 ， 作 为 一 个 Observable， 观 察 者 们 或 者 其 它 
Subject 都 可 以 订阅 它 。 


一 旦 Subject 订 阅 了 Observable， 它 将 会 触发 Observable 开 始 发 射 。 如 果 原 始 的 
Observable 是 “ 冷 " 的 ， 这 将 会 对 订阅 一 个 “ 热 " 的 Observable 变 量 产 生 影 响 。 


RxJava 提 供 四 种 不 同 的 Subject : 


e PublishSubject 
e BehaviorSubject 
e ReplaySubject. 
e AsyncSubject 


PublishSubject 


Publish 是 Subject 的 一 个 基础 子 类 。 让 我 们 看 看 用 PublishSubject 实 现 传统 的 
Observable Hello world : 


PublishSubject<String> stringPublishSubject = PublishSubject.cre 
ate(); 
Subscription subscriptionPrint = stringPublishSubject.subscribe( 
new Observer<String>() { 
@Override 
public void onCompleted() { 
System.out.println("Observable completed"); 


@Override 
public void onError(Throwable e) { 
System.out.println("Oh,no!Something wrong happened!"); 


@Override 
public void onNext(String message) { 
System.out.println(message); 


3); 
stringPublishSubject.onNext ("Hello World"); 


在 刚才 的 例子 中 ， 我 们 创建 了 一 个 PublishSubject ， 用 create() 方法 发 射 一 
个 String 值 ， 然 后 我 们 订阅 了 PublishSubject。 此 时 ， 没 有 数据 要 发 送 ， 因 此 我 
们 的 观察 者 只 能 等 待 ， 没 有 阻塞 线程 ， 也 没有 消耗 资源 。 就 在 这 随时 准备 从 subject 
接收 值 ， 如 果 Subject 没 有 发 射 值 那么 我 们 的 观察 者 就 会 一 直 在 等 待 。 再 次 声明 的 
是 ， 无 需 担心 : 观察 者 知道 在 每 个 场景 中 该 做 什么 ， 我 们 不 用 担心 什么 时 候 是 因为 
它 是 响应 式 的 : 系统 会 响应 。 我 们 并 不 关心 它 什 么 时 候 响 应 。 我 们 只 关心 它 响应 时 
该 做 什么 


最 后 一 行 代码 展示 了 手动 发 射 字符 串 “Hello World”, CARR T MRA 
的 onNext() 方法 ， 让 我 们 在 控制 台 打 印 出 “Hello World" 信 息 。 


A 。 话 说 我 们 有 一 个 private 声明 的 Observable， 外 部 
能 访问 。Observable 在 它 生 命 周 期 内 发 射 值 ， 我 们 不 用 关心 这 些 值 ， 我 们 只 关心 
a ER o 


首先 ， 我 们 创建 一 个 新 的 PublishSubject 来 响应 它 的 onNext() 方法 ， 并 且 外 部 也 
TATAE 


final PublishSubject<Boolean> subject = PublishSubject.create(); 


subject.subscribe(new Observer<Boolean>() { 
@Override 
public void onCompleted() { 


@Override 
public void onError(Throwable e) { 


@Override 
public void onNext(Boolean aBoolean) { 
System.out.println("Observable Completed"); 


3); 


然后 ， 我 们 创建 “私有 "的 Observable， 只 有 subject 才 可 以 访问 的 到 。 


Observable.create(new Observable.OnSubscribe<Integer>() { 
@Override 
public void call(Subscriber<? super Integer> subscriber) { 
fOr Aint = 0 Les da 
subscriber .onNext(i); 


} 


subscriber .onCompleted(); 
} 
}).doOnCompleted(new Actiono() { 
@Override 
public void calli) { 
subject.onNext (true); 


} 


}).subscribe(); 


observable.create() 方法 包含 了 我 们 熟悉 的 for 循 环 ， 发 射 数 

Fe dooncompleted() 方法 指定 当 Observable 结 束 时 要 做 什么 事情 : 在 subject 上 
发 射 true。 最 后 ， 我 们 订阅 了 Observable。 很 明显 ， 空 的 oa 调用 仅仅 

是 为 了 开启 Observable， 而 不 用 管 已 发 出 的 任何 值 ， 也 不 用 管 完成 事件 或 者 错误 事 
件 。 为 了 这 个 例子 我 们 需要 它 像 这 样 。 


在 这 个 例子 中 ， 我 们 创建 了 一 个 可 以 连接 Observables 并 且 同 时 可 被 观测 的 实体 。 
当 我 们 想 为 公共 资源 创建 独立 、 抽 象 或 更 多 观测 的 点 时 ， 这 是 极其 有 用 的 。 


BehaviorSubject 


简单 的 说 ，BehaviorSubject 会 首先 向 他 的 订阅 者 发 送 截至 订阅 前 最 新 的 一 个 数据 对 
E (或 初始 值 ) ,然后 正常 发 送 订阅 后 的 数据 流 。 


BehaviorSubject<Integer> behaviorSubject = BehaviorSubject.creat 
e(1); 


在 这 个 短 例子 中 ， 我 们 创建 了 一 个 能 发 射 整形 (Integer) 的 BehaviorSubject。 由 于 每 
当 Observes 订 阅 它 时 就 会 发 射 最 新 的 数据 ， 所 以 它 需 要 一 个 初始 值 。 


ReplaySubject 
ReplaySubject 会 缓存 它 所 订阅 的 所 有 数据 ,向 任意 一 个 订阅 它 的 观察 者 重 发 : 


ReplaySubject<Integer> replaySubject = ReplaySubject.create(); 


AsyncSubject 


当 Observable 完 成 时 AsyncSubject 只 会 发 布 最 后 一 个 数据 给 已 经 订阅 的 每 一 个 观察 
* o 


AsyncSubject<Integer> asyncSubject = AsyncSubject.create(); 


Subject = Observable + Observer 
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本 章 中 ， 我 们 了 解 到 了 什么 是 观察 者 模式 ， 为 什么 Observables 在 今天 的 编程 场景 
中 如 此 重要 ， 以 及 如 何 创建 Observables 和 subjects。 


下 一 章 中 ， 我 们 将 创建 第 一 个 基于 RxJava 的 Android 应 用 程序 ， 学 习 如 何 检 索 数 据 
来 填充 listview， 以 及 探索 如 何 创 建 一 个 基于 RxJava 的 响应 式 Ul 。 


向 响应 式 世界 问好 


在 上 一 章 中 ， 我 们 对 观察 者 模式 有 个 理论 上 的 快速 概述 。 我 们 也 看 了 从 头 开 始 、 从 
列表 、 或 者 从 已 经 存在 的 函数 来 创建 DObservables。 在 本 章 中 ， 我 们 将 用 我 们 学 到 
的 来 创建 我 们 第 一 个 响应 式 Android 应 用 程序 。 首 先 ， 我 们 需要 搭建 环境 ， 导 入 需 
要 的 库 和 有 用 的 库 。 然 后 我 们 将 创建 一 个 简单 的 应 用 程序 ， 在 不 同 的 flavors 中 包含 
几 个 用 RxJava 卉 充 的 RecycleView items ° 


启动 引擎 

我 们 将 使 用 IntelliJ IDEA/Android Studio 来 创建 这 个 工程 ， 因 此 你 会 对 截图 看 起 来 比 
BA o 

让 我 们 开始 创建 一 个 新 的 Android 工 程 。 你 可 以 创建 你 自己 的 工程 或 者 用 本 书 中 提 
供 的 导入 。 选 择 你 自己 喜欢 的 创建 方式 这 取决 于 你 。 


如 果 你 想 用 Android Studio 创 建 一 个 新 的 工程 ， 通 常 你 可 以 参考 官方 文 
档 : http://developer.android.com/intl/zh-cn/training/basics/firstapp/creating- 
project.html 


Kal Welcome to Android Studio 


Create New Project 


Hello Reactive World 


Packtpub 


com.packtpubl helloreactiveworld 


[Users /hamen/code/HelloReactiveWorid 





依赖 
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很 明显 ， 我 们 将 使 用 Gradle 来 管理 我 们 的 依赖 列表 。 我 们 的 build.gradble 文 件 看 起 
来 像 这 样 : 


Sbuildscript { 
9 repositories { 
mavencentral() 
} 


dependencies { 
classpath ‘me, tatarka:gradle-retrolambda:2.5.@' 


repositories { 
mavenCentral() 
ô} 


apply plugin: 'com.android.application' 
apply plugin: 'me.tatarka, retrolambda' 


GEERESeevausune 


android { 
compileSdkVersion 21 
buildToolsVersion “21.1.2” 


defaultConfig { 
applicationId “com. packtpub.apps.rxjava_essentials” 
minSdkVersion 16 
targetSdkVersion 21 
versionCode 1 
versionName "1,0" 
} 


buildTypes { 
release { 
minifyEnabled false 


proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 
} 
compileOptions { 


sourceCompatibility JavaVersion. VERSION 1 8 
targetCompatibility JavaVersion. VERSION 1 8 


} 
LintOptions { 


disable 'InvalidPackage' 
} 


packagingOptions { 
exclude 'META-INF/services/javax.annotation.processing.Processor' 


dependencies { 
compile fileTree(dir: ‘libs’, include: ['*.jar']) 
compile 'com.android.support:support-v4:21.0.3' 
compile “com.android. support: appcompat-v7:21.8.3" 
compile ‘com.android.support: recyclerview-v7:21.0.8' 
compile 'com.android.support:cardview-v7:21.0.3' 


compile ‘org.projectlombok: Lombok:1.14.8' 
compile ‘com. jakewharton:butterknife:6.0.0° 


compile ‘io. reactivex: rxandroid:0.24.0'| 
> 





正如 你 看 到 的 我 们 引入 了 RxAndroid。RxAndroid 是 RxJava 的 增强 版 ， 尤 其 是 针对 
Android 设 计 的 。 
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RxAndroid 


RxAndroid 是 RxJava 家 族 的 一 部 分 。 它 基于 RxJava1.0.x, 在 普通 的 RxJava 基 础 上 添 
加 了 几 个 有 用 的 类 。 大 多 数 情 况 下 ， 它 为 Android 添 加 了 特殊 的 调度 器 。 我 们 将 在 
第 七 章 Schedulers-Defeating the Android MainThread lssue 再 讨论 它 。 


TA 


出 于 实用 ， 我 们 引入 了 Lombok 和 Butter Knife。 这 两 个 可 以 帮助 我 们 在 Android 应 
用 程序 中 少 写 许多 模板 类 代码 。 
Lombok 


Lombok 使 用 注解 的 方式 为 你 生成 许多 代码 。 大 多 数 情 况 下 我 们 使 用 其 生 
成 getter/setter ` toString() ` equals() ` hashCode() 。 它 来 自 于 一 
4 Gradle tk # fe Android Studio 插 件 。 


Butter Knife 


Butter Knife 使 用 注解 的 方式 来 帮助 我 们 免 去 写 findviewById() 和 设置 点 击 监听 
的 痛苦 。 至 于 Lombok, 我 们 可 以 通过 导入 依赖 和 安装 Android Studio 插 件 来 获得 更 好 
的 体验 。 


Retrolambda 


最 后 ， 我 们 导入 Retrolambda， 是 因为 我 们 开发 的 Android 是 基于 Java 1.6， 然 后 我 
们 可 以 借助 它 来 实现 Java 8 Lambda HUM wh PIF S REM RUE o 


我 们 的 第 一 个 Qbservable 


在 我 们 的 第 一 个 列子 里 ， 我 们 将 检索 安装 的 应 用 列表 并 填充 RecycleView 的 item 来 
展示 它们 。 我 们 也 设想 一 个 下 拉 刷 新 的 功能 和 一 个 进度 条 来 告知 用 户 当前 任务 正在 
执行 。 

首先 ， 我 们 创建 Observable。 我 们 需要 一 个 函数 来 检索 安装 的 应 用 程序 列表 并 把 它 
提供 给 我 们 的 观察 者 。 我 们 一 个 接 一 个 的 发 射 这 些 应 用 程序 数据 ， 将 它们 分 组 到 一 
个 单独 的 列表 中 ， 以 此 来 展示 响应 式 方法 的 灵活 性 。 


private Observable<AppInfo> getApps( ){ 
return Observable.create(subscriber -> { 
List<AppInfoRich> apps = new ArrayList<AppInfoRich>(); 


final Intent mainIntent = new Intent(Intent.ACTION MAIN, 


null); 
mainIntent.addCategory(Intent.CATEGORY LAUNCHER) ; 


List<ResolveInfo> infos = getActivity().getPackageManage 
r().queryIntentActivities(mainIntent, 0); 


for(ResolveInfo info : infos){ 
apps.add(new AppInfoRich(getActivity( ), info)); 


for (AppInfoRich appInfo:apps) { 
Bitmap icon = Utils.drawableToBitmap(appInfo.getIcon 


O); 
String name = appInfo.getName(); 
String iconPath = mFilesDir + "/" + name; 


Utils.storeBitmap(App.instance, icon, name); 


if (subscriber .isUnsubscribed() ){ 
return; 


} 


subscriber .onNext (new AppInfo(name, iconPath,appInfo. 


getLastUpdateTime())); 
} 


if (!subscriber.isUnsubscribed()){ 
subscriber .onCompleted(); 


}); 


Applnfo 对 象 如 下 : 


@Data 
@Accessors(prefix = "m") 
public class AppInfo implements Comparable<Object> { 


long mLastUpdateTime; 
String mName; 
String mIcon; 


public AppInfo(String nName, long lastUpdateTime, String ico 
n) { 


mName = nName; 
mIcon = icon; 
mLastUpdateTime = lastUpdateTime; 


@Override 

public int compareTo(Object another) { 
AppInfo f = (AppInfo)another; 
return getName().compareTo(f.getName()); 


需要 重点 注意 的 是 在 发 射 新 的 数据 或 者 完成 序列 之 前 要 检测 观察 者 的 订阅 情况 。 这 
样 的 话 代码 会 更 高 效 ， 因 为 如 果 没 有 观察 者 等 待 时 我 们 就 不 生成 没有 必要 的 数据 
项 o 


此 时 ， 我 们 可 以 订阅 Observable 并 观察 它 。 订 阅 一 个 DObservable 意 味 着 当 我 们 需要 
的 数据 进来 时 我 们 必须 提供 对 应 的 操作 来 执行 它 


当前 的 场景 是 什么 ?我 们 展示 一 个 进度 条 来 等 待 数据 。 当 数据 到 来 时 ， 我 们 需要 隐 
藏 掉 进 度 条 ,填充 list, 最 终 展 示 列 表 。 Si ， 我 们 知道 当 一 切 都 准备 好 了 该 做 什么 
那么 错误 的 场景 呢 ? 对 于 错误 这 种 情况 ， 我 们 仅仅 是 用 Toast 展 示 一 个 错误 的 信息 。 


使 用 Butter Knife ,我们 得 到 list 和 下 拉 刷 新 组 件 的 引用 : 


A 
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@InjetcView(R.id.fragment first example list) 
RecyclerView mRecycleView; 


@InjectView(R.id.fragment first example swipe container) 
SwipeRefreshLayout mSwipeRefreshLayout; 


我 们 使 用 Android 5 的 标准 组 件 : RecyclerView 和 SwipeRefreshLayout。 截 屏 展 示 
了 我 们 这 个 简单 App 的 list Fragment 的 layout 文 件 : 














c MainActivityjava x | C` FirstExampleFragmentjava x © fragment first example.xml x 


TE 1 





1 © 口 <FrameLayout xmins:android="http://schemas.android.com/apk/res/android" 
2 xmins:tools="http://schemas.android.com/tools” 
3 android: layout width="match parent" 
4 android: layout height="match parent" 
5 tools: context="com. packtpub.apps.rxjava essentials.examplel.FirstExampleFragment"> 
6 
7 <android.support.v4.widget . SwipeRefreshLayout 
8 android: id="G+id/fragment first example swipe container" 
9 android: layout width="match parent" 
10 android: layout height="match parent"> 
11 
12 Ç <android.support.v7.widget.RecyclerView 
13 android: id="G+id/fragment first example list" 
14 android: clipToPadding="false” 
15 android: layout width="match parent" 


16 android: layout height="match parent" 

17 android: paddingRight="edimen/activity horizontal margin" 
18 android: paddingLeft="edimen/activity horizontal margin” 
android: paddingTop="Gdimen/activity horizontal margin” 

0 A android: paddingBottom="edimen/activity vertical margin"/> 
</android.support.v4.widget.SwipeRefreshLayout> 


»</FrameLayout> 







我 们 使 用 一 个 下 拉 刷 新 方法 ， 因 此 列表 数据 可 以 来 自 初 始 化 加 载 ， 或 由 用 户 触 发 的 
一 个 刷新 动作 。 针 对 这 两 个 场景 ， 我 们 用 同样 的 行为 ， 因 此 我 们 把 我 们 的 观察 者 放 
在 一 个 易 被 复 用 的 函数 里 面 。 下 面 是 我 们 的 观察 者 ， 定 义 了 成 功 、 失 败 、 完 成 要 做 
的 事情 : 
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private void refreshTheList() { 
getApps().toSortedList() 
.subscribe(new Observer<List<AppInfo>>() { 


@Override 
public void onCompleted() { 
Toast .makeText (getActivity(), "Here is the 1 
ist!", Toast.LENGTH_LONG) .show(); 


} 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity( ), "Something wen 
t wrong!", Toast .LENGTH SHORT ).show( ); 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 

public void onNext(List<AppInfo> appInfos) { 
mRecyclerView.setVisibility(View.VISIBLE); 
mAdapter .addApplications(appInfos); 
mSwipeRefreshLayout. setRefreshing(false); 


3); 


定义 一 个 函数 使 我 们 能 够 用 同样 一 个 block 来 处 理 两 种 场景 成 为 了 可 能 。 当 fragment 
加 载 时 我 们 只 需 调用 refreshTheList() 方法 并 设置 refreshTheList() 方法 作 
为 用 户 下 拉 这 一 行为 所 触发 的 方法 。 


mSwipeRefreshLayout. setOnRefreshListener(this::refreshTheList); 


我 们 第 一 个 例子 现在 完成 了 ， 运 行 跑 一 下 。 


RxJava Essentials 


O vis O 1909 


==:  RxJava Essentials 


El 9GAG 


e AdSense 


WS AirDroid 


a Amazon Kindle 


PS Analytics 
[ul] Andlytics 





从 列表 创建 一 个 Dbservable 


在 这 个 例子 中 ， 我 们 将 引入 from() BELO RR MAFI AIO EE" BA BAN VA 
从 一 个 列表 中 创建 一 个 Observable。Observable 将 发 射出 列表 中 的 每 一 个 元 素 ， 我 
们 可 以 通过 订阅 它们 来 对 这 些 发 出 的 元 素 做 出 响应 。 


为 了 实现 和 第 一 个 例子 同样 的 结果 ， 我 们 在 每 一 个 onNext() 函数 更 新 我 们 的 适 配 
器 ， 添 加 元 素 并 通知 插入 。 


我 们 将 复 用 和 第 一 个 例子 同样 的 结构 。 主 要 的 不 同 的 是 我 们 不 再 检索 已 安装 的 应 用 
列表 。 列 表 由 外 部 实体 提供 : 


mApps = ApplicationsList.getInstance().getList(); 


获得 列表 后 ， 我 们 仅 需 将 它 响应 化 并 填充 RecyclerView 的 item: 


private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 


Observable.from(apps) 
.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 
mSwipeRefreshLayout.setRefreshing(false); 


Toast .makeText (getActivity(), "Here is the 1 
ist!", Toast.LENGTH LONG).show(); 
} 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity( ), "Something wen 


t wrong!", Toast .LENGTH SHORT) .show( ); 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 

public void onNext (AppInfo appInfo) { 
mAddedApps.add(appInfo); 
mAdapter.addApplication(mAddedApps.size() - 1 


,appinfo); 


3); 
} 

A] — el 
正如 你 看 到 的 ， 我 们 将 已 安装 的 应 用 程序 列表 作为 参数 传 进 from() 函数 ， 然 后 我 
们 订阅 生成 的 Observable。 观 察 者 和 我 们 第 一 个 例子 中 的 观察 者 十 分 相像 。 一 个 主 
要 的 不 同 是 我 们 在 onCompleted() 函数 中 停 掉 进度 条 是 因为 我 们 一 个 一 个 的 发 射 
TLE ; 第 一 个 例子 中 的 Observable 发 射 的 是 整个 list, 因 此 在 onNext() 函数 中 停 掉 
进度 条 的 做 法 是 安全 的 。 


再 多 几 个 例子 
在 这 一 节 中 ， 我 们 将 基于 RxJava 


的 just() , repeat() , defer() , range() , interval() ,和 timer() 方法 
展示 一 些 例子 。 


just() 


假如 我 们 只 有 3 个 独立 的 Applnfo 对 象 并 且 我 们 想 把 他 们 转化 为 Observable 并 填充 到 
RecyclerView 的 item 中 : 


List<AppInfo> apps = ApplicationsList.getInstance().getList(); 


AppInfo appOne = apps.get(0); 


AppInfo appTwo = apps.get(10); 
AppInfo appThree = apps.get(24); 


loadApps(appOne, appTwo, appThree); 


我 们 可 以 像 我 们 之 前 的 例子 那样 检索 列表 并 提取 出 这 三 个 元 素 。 然 后 我 们 将 他 们 传 
到 这 个 loadApps() BE: 


private void loadApps(AppInfo appOne, AppInfo appTwo, AppInfo appT 
hree) { 


mRecyclerView.setVisibility(View.VISIBLE); 
Observable. just(appOne, appTwo, appThree) 
.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 
mSwipeRefreshLayout.setRefreshing(false); 
Toast .makeText (getActivity(), "Here is the 1 
ist!", Toast.LENGTH_LONG) .show(); 


} 


@Override 
public void onError(Throwable e) { 
Toast .makeText(getActivity(), "Something wen 
t wrong!", Toast.LENGTH SHORT).show(); 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onNext (AppInfo appInfo) { 
mAddedApps.add(appInfo); 


mAdapter.addApplication(mAddedApps.size() - 1 
‚appInfo); 


}); 

} 
a J 
正如 你 看 到 的 ， 代 码 和 之 前 的 例子 很 像 。 这 种 方法 让 我 们 有 机 会 来 考虑 一 下 代码 的 
复 用 。 


WT RRA SRR just) 方法 ， 你 将 会 得 到 一 个 已 存在 代码 的 原始 
Observable 版 本 。 在 一 个 新 的 响应 式 架 构 的 基础 上 迁移 已 存在 的 代码 ， 这 个 方法 可 
能 是 一 个 有 用 的 开始 点 。 


repeat() 


假如 你 想 对 一 个 Observable 重 复发 射 三 次 数据 。 例 如 ， 我 们 用 just() 例子 中 的 
Observable : 


private void loadApps(AppInfo appOne, AppInfo appTwo, AppInfo appT 
hree) { 
mRecyclerView.setVisibility(View.VISIBLE); 
Observable. just(appOne, appTwo, appThree) 
.repeat(3) 
.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 
mSwipeRefreshLayout.setRefreshing(false); 
Toast .makeText (getActivity(), "Here is the 1 
ist!", Toast.LENGTH LONG).show(); 


} 


@Override 
public void onError(Throwable e) { 
Toast .makeText(getActivity(), "Something wen 
t wrong!", Toast.LENGTH SHORT).show(); 
mSwipeRefreshLayout.setRefreshing(false); 


@Override 
public void onNext(AppInfo appInfo) { 
mAddedApps.add(appInfo); 
mAdapter.addApplication(mAddedApps.size() - 1 
‚appInfo); 


+); 
} 
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正如 你 看 到 的 ， 我 们 在 just() 创建 Observable 后 追加 了 repeat(3) ， 它 将 会 创 
建 9 个 元 素 的 序列 ， 每 一 个 都 单独 发 射 。 


defer() 


有 这 样 一 个 场景 ， 你 想 在 这 声明 一 个 DObservable 但 是 你 又 想 推迟 这 个 Observable 的 
创建 直到 观察 者 订阅 时 。 看 下 面 的 getInt() BH: 


private Observable<Integer> getInt(){ 
return Observable.create(subscriber -> { 
if(subscriber.isUnsubscribed( )){ 
return; 


} 
App.L.debug("GETINT"); 


subscriber .onNext(42); 
subscriber .onCompleted(); 


3); 
这 比较 简单 ， 并 且 它 没有 做 太 多 事情 ， 但 是 它 正好 为 我 们 服务 。 现 在 ， 我 们 可 以 创 
建 一 个 新 的 Observable 并 且 应 用 defer() : 


Observable<Integer> deferred = Observable.defer(this::getInt); 


这 次 ， deferred 存在 ， 但 是 getInt() create() 方法 还 没有 调用 :logcat 日 & 
也 没有 “GETINT” 打 印 出 来 : 


deferred.subscribe(number -> { 
App.L.debug(String.valueof (number)); 


3); 


但 是 一 旦 我 们 订阅 了 ， create() 方法 就 会 被 调用 并 且 我 们 也 可 以 在 logcat 日 志 
得 到 下 卖弄 两 个 : GETINT 和 42。 


range() 


你 需要 从 一 个 指定 的 数字 X 开 始 发 射 N 个 数字 吗 ? 你 可 以 用 range : 


Observable.range(10,3) 
.subscribe(new Observer<Integer>() { 


@Override 
public void onCompleted() { 
Toast.makeText(getActivity(), "Yeaaah!", Toast.LENGT 
H_LONG) .show(); 


} 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity(), "Something went wrong!" 
, TOast.LENGTH_SHORT).show(); 
} 


@Override 
public void onNext (Integer number) { 
Toast .makeText(getActivity(), "I say " + number, Toa 
st. LENGTH SHORT).show(); 


range() 函数 用 两 个 数字 作为 参数 : 第 一 个 是 起 始点 ， 第 二 个 是 我 们 想 发 射 数 字 
的 个 数 。 


interval() 


interval() 函数 在 你 需要 创建 一 个 轮 询 程 序 时 非常 好 用 。 


Subscription stopMePlease = Observable.interval(3, TimeUnit.SECON 
DS) 
.subscribe(new Observer<Integer>() { 


@Override 
public void onCompleted() { 
Toast.makeText(getActivity(), "Yeaaah!", Toast.LENGT 
H LONG).show(); 


} 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity(), "Something went wrong!" 
, TOast.LENGTH_SHORT).show(); 


} 


@Override 
public void onNext(Integer number) { 
Toast .makeText(getActivity(), "I say " + number, Toa 
st. LENGTH SHORT).show(); 


interval() BRAS: 一 个 指定 两 次 发 射 的 时 间 间 隔 ， 另 一 个 是 用 到 的 
时 间 单 位 。 
timer() 


如 果 你 需要 一 个 一 段 时 间 之 后 才 发 射 的 Observable， 你 可 以 像 下 面 的 例子 使 
用 timer() 


Observable. timer (3, TimeUnit.SECONDS) 
.subscribe(new Observer<Long>() { 


@Override 
public void onCompleted() { 


@Override 
public void onError(Throwable e) { 


@Override 
public void onNext(Long number) { 
Log.d("RXJAVA", "I say " + number); 


}); 


它 将 3 秒 后 发 射 0, 然 后 就 完成 了 。 让 我 们 使 用 timer() 的 第 三 个 参数 ， 就 像 下 面 的 
例子 : 


Observable. timer (3,3, TimeUnit.SECONDS) 
.subscribe(new Observer<Long>() { 


@Override 
public void onCompleted() { 


@Override 
public void onError(Throwable e) { 


@Override 
public void onNext (Long number) { 
Log.d("RXJAVA", "I say " + number); 


}); 


用 这 个 代码 ， 你 可 以 创建 一 个 以 初始 值 来 延迟 (上 一 个 例子 是 3 秒 ) 执行 
的 interval() 版 本 ， 然 后 每 隔 N 秒 就 发 射 一 个 新 的 数字 (前 面 的 例子 是 3 秒 ) © 
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在 本 章 中 ， 我 们 创建 了 第 一 个 由 RxJava 强 化 的 Android 应 用 程序 。 我 们 从 头 、 从 已 
有 的 列表 、 从 已 有 的 函数 来 创建 Observable。 我 们 也 学 习 了 如 何 创 建 重 复发 射 的 
Observables， [4] ha £ 4 )Observables vi A 2E 3K & At 89 Observables º 

在 下 一 章 中 ， 我 们 将 掌握 过 滤 操 作 ， 能 够 从 我 们 接收 到 的 序列 中 创建 我 们 需要 的 序 
列 o 


at X Observables 


在 上 一 章 中 ， 我 们 学 习 了 使 用 RxJava 创 建 一 个 Android 工 程 以 及 如 何 创 建 一 个 可 观 
测 的 列表 来 填充 RecyclerView。 我 们 现在 知道 了 如 何 从 头 、 从 列表 、 从 一 个 已 存在 
a 44 Aava $ Kk 41 3 Observable ° 


这 一 章 中 ， 我 们 将 研究 可 观测 序列 的 本 质 : 过 滤 。 我 们 将 学 到 如 何 从 发 射 的 
Observable 中 选取 我 们 想 要 的 值 ， 如何 获 取 有 限 个 数 的 值 ， 如何 处 理 溢 出 的 场景 ， 
以 及 更 多 的 有 用 的 技巧 。 


过 滤 序 列 


RxJava 让 我 们 使 用 filter) 方法 来 过 滤 我 们 观测 序列 中 不 想 要 的 值 ， 在 上 一 章 
中 ， 我 们 在 几 个 例子 中 使 用 了 已 安装 的 应 用 列表 ， 但 是 我 们 只 想 展 示 以 字母 CH 
mo o. 
我 们 会 过 滤 它 过 把 合适 的 谓词 传 给 filter() 函数 来 得 到 我 们 想 要 的 值 。 


上 一 章 中 loadList() 函数 可 以 改 成 这 样 : 


private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 
Observable.from(apps) 
.filter((appInfo) -> 
appInfo.getName().startswith("C")) 
.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity(), "Something wen 
t wrong!", Toast.LENGTH SHORT).show(); 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onNext (AppInfo appInfo) { 
mAddedApps.add(appInfo); 
mAdapter .addApplication(mAddedApps.size() - 1 
‚appInfo); 


}); 








我 们 从 上 一 章 中 的 loadList() 函数 中 添加 下 面 一 行 : 


.fliter((appInfo -> appInfo.getName().startswWith("C")) 


创建 Observable 完 以 后 ， 我 们 从 发 出 的 每 个 元 素 中 过 滤 掉 开头 字母 不 是 C 的 。 为 了 
让 这 里 更 清楚 一 些 ， 我 们 用 Java 7 的 语法 来 实现 : 


filter (new Funci<AppInfo,Boolean>(){ 
@Override 
public Boolean call(AppInfo appInfo){ 
return appInfo.getName().startswWith("C"); 


3) 


我 们 传 一 个 新 的 Funct 对 象 给 filter() 函数 ， 即 只 有 一 个 参数 的 函 

Ke Funct 有 一 个 AppInfo 对 象 来 作为 它 的 参数 类 型 并 且 返 回 Boolean 对 象 。 
只 要 条 件 符合 filter() 函数 就 会 返回 true 。 此 时 ， 值 会 发 射出 去 并 且 所 有 的 
观察 者 都 会 接收 到 。 


正如 你 想 的 那样 ， 从 一 个 我 们 得 到 的 可 观测 序列 中 创建 一 个 我 们 需要 的 序 
A) filter() 是 很 好 用 的 。 我 们 不 需要 知道 可 观测 序列 的 源 或 者 为 什么 发 射 这 么 多 
不 同 的 数据 。 我 们 只 是 想 要 这 些 元 素 的 子 集 来 创建 一 个 可 以 在 应 用 中 使 用 的 新 序 
列 。 这 种 思想 促进 了 我 们 编码 中 的 分 离 性 与 抽象 性 。 


filter() 函数 最 常用 的 用 法 之 一 时 过 滤 null 对 象 : 


filter (new Func1<AppInfo, Boolean>(){ 
@Override 
public Boolean call(AppInfo appInfo){ 
return appInfo != null; 


}) 


这 看 起 来 简单 ， 对 于 简单 的 事情 有 许多 模板 代码 ， 但 是 它 帮 有 我们 免 去 了 
在 onNext() 函数 调用 中 再 去 检测 null 值 ， 让 我 们 把 注意 力 集中 在 应 用 业务 加 
辑 上 。 


下 图 展示 了 过 滤 出 的 C 字 母 开 头 的 已 安装 的 应 用 列表 。 
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Sk > Ar E * 
获取 我 们 需要 的 数据 

当 我 们 不 需要 整个 序列 时 ， 而 是 只 想 取 开头 或 结尾 的 几 个 元 素 ， 我 们 可 以 
用 take() 或 takeLast() 。 


Take 


如 果 我 们 只 想 要 一 个 可 观测 序列 中 的 前 三 个 元 素 那 将 会 怎么 样 ， 发 射 它们 ， 然 后 让 
Observable 完 成 吗 ? take() 函数 用 整数 N 来 作为 一 个 参数 ， 从 原始 的 序列 中 发 射 
前 NN 个 元 素 ， 然 后 完成 : 


private void loadList(List<AppInfo> apps) { 


mRecyclerView.setVisibility(View.VISIBLE); 
Observable.from(apps) 


.take(3) 


.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 


mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onError(Throwable e) { 


Toast .makeText (getActivity( ), "Something wen 
t wrong!", Toast .LENGTH SHORT) .show( ); 


mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onNext (AppInfo appInfo) { 
mAddedApps.add(appInfo); 


mAdapter .addApplication(mAddedApps.size() - 1 
‚appInfo); 


下 图 中 展示 了 发 射 数字 的 一 个 可 观测 序列 。 我 们 对 这 个 可 观测 序列 应 


用 take(2) 函数 ， 然 后 我 们 创建 一 个 只 发 射 可 观测 源 的 第 一 个 和 第 二 个 数据 的 新 
序列 o 





take(2) 


TakeLast 
如 果 我 们 想 要 最 后 N 个 元 素 ， 我 们 只 需 使 用 takeLast() BH: 


Observable.from(apps) 
.takeLast(3) 
- Ssubscribe(...); 


正如 听 起 来 那样 不 值 一 提 ， 值 得 注意 的 是 因为 takeLast() 方 法 只 能 作用 于 一 组 有 限 
的 序列 (发 射 元 素 ) ， 它 只 能 应 用 于 一 个 完整 的 序列 。 


下 图 中 展示 了 如 何 从 可 观测 源 中 发 射 最 后 一 个 元 素来 创建 一 个 新 的 序列 : 
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takeLast(1) 
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下 图 中 展示 了 我 们 在 已 安装 的 应 用 列表 使 用 take() 和 takeLast() BRERA 
的 结果 : 
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有 且 仅 有 一 次 

一 个 可 观测 序列 会 在 出 错时 重复 发 射 或 者 被 设计 成 重复 发 

Ate distinct() 和 distinctUntilChanged() BT VAZ 1E fn) RAT AL ZE t 
重复 问题 。 

Distinct 

如 果 我 们 想 对 一 个 指定 的 值 仅 处 理 一 次 该 怎么 办 ? 我 们 可 以 对 我 们 的 序列 使 

用 distinct() 函数 去 掉 重 复 的 。 就 像 takeLast() 一 样 ， distinct() 作用 于 


一 个 完整 的 序列 ， 然 后 得 到 重复 的 过 滤 项 ， 它 需要 记录 每 一 个 发 射 的 值 。 如 果 你 在 
处 理 一 大 扒 序列 或 者 大 的 数据 记得 关注 内 存 使 用 情况 。 


下 图 展示 了 如 何在 一 个 发 射 1 和 2 两 次 的 可 观测 源 上 创建 一 个 无 重 的 序列 : 


distinct 


一 9 一 9 o — — 





为 了 创建 我 们 例子 中 序列 ， 我 们 将 使 用 我 们 至 今 已 经 学 到 的 几 个 方法 : 


e take() : 它 有 一 小 组 的 可 识别 的 数据 项 。 
e repeat() :创建 一 个 有 重复 的 大 的 序列 。 


然后 ， 我 们 将 应 用 distinct() BKRKAREZ ° 
注意 


我 们 用 程序 实现 一 个 重复 的 序列 ， 然 后 过 滤 出 它们 。 这 听 起 来 时 不 可 思议 的 ， 但 是 
为 了 实现 这 个 例子 来 使 用 我 们 至 今 为 止 已 学 习 到 的 东西 则 是 个 不 错 的 练习 。 


Observable<AppInfo> fullofDuplicates = Observable.from(apps) 
. take(3) 
.repeat(3); 


fullofDuplicates 变量 里 把 我 们 已 安装 应 用 的 前 三 个 重复 了 3 次 : 有 9 个 并 且 许 
多 重复 的 。 然 后 ， 我 们 使 用 distinct() : 


fullofDuplicates.distinct() 
.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity( ), "Something wen 
t wrong!", Toast.LENGTH SHORT) .show( ); 
mSwipeRefreshLayout.setRefreshing(false); 


@Override 
public void onNext(AppInfo appInfo) { 
mAddedApps.add(appInfo); 
mAdapter.addApplication(mAddedApps.size() - 1 
‚appInfo); 


结果 ， 很 明显 ， 我 们 得 到 : 
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DistinctUntilsChanged 


如 果 在 一 个 可 观测 序列 发 射 一 个 不 同 于 之 前 的 一 个 新 值 时 让 我 们 得 到 通知 这 时 候 该 
怎么 做 ?了 我 们 猜想 一 下 我 们 观测 的 温度 传感器 ， 每 秒 发 射 的 室内 温度 : 


每 次 我 们 获得 一 个 新 值 ， 我 们 都 会 更 新 当前 正在 显示 的 温度 。 我 们 出 于 系统 资源 保 
护 并 不 想 在 每 次 值 一 样 时 更 新 数据 。 CAMBRA en 
才 想 得 到 通知 。 ditinctuntilChanged() 过 滤 函 数 能 做 到 这 一 点 。 它 能 轻易 的 忽 
略 掉 所 有 的 重复 并 且 只 发 射出 新 的 值 。 


下 图 用 图 形 化 的 方式 展示 了 我 们 如 何 将 Terra 函数 应 用 在 一 
个 存在 的 序列 上 来 创建 一 个 新 的 不 重复 发 射 元 素 的 序列 。 








First and last 


下 图 展示 了 如 何 从 一 个 从 可 观测 源 序 列 中 创建 只 发 射 第 一 个 元 素 的 序列 





first 


first() 方法 和 last() 方法 很 容易 弄 明 白 。 它 们 从 Observable 中 只 发 射 第 一 个 
元 素 或 者 最 后 一 个 元 素 。 这 两 个 都 可 以 传 Funci 作为 参数 ，: 一 个 可 以 确定 我 们 
感 兴趣 的 第 一 个 或 者 最 后 一 个 的 谓词 : 


下 图 展示 了 last() 应 用 在 一 个 完成 的 序列 上 来 创建 一 个 仅仅 发 射 最 后 一 个 元 素 的 
新 的 Observable ° 


last 


与 first() 和 last() 相似 的 变量 

A: firstorDefault() 和 lastorDefault() .这 两 个 函数 当 可 观测 序列 完成 时 
不 再 发 射 任何 值 时 用 得 上 。 在 这 种 场景 下 ， 如 果 Observable 不 再 发 射 任何 值 时 我 们 
可 以 指定 发 射 一 个 默认 的 值 


First and last 
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Skip and SkipLast 


下 图 中 展示 了 如 何 使 用 skip(2) 来 创建 一 个 不 发 射 前 两 个 元 素 而 是 发 射 它 后 面 的 
那些 数据 的 序列 。 


skip(2) 


skip() 和 skipLast() 函数 与 take() 和 takeLast() 相对 应 。 它 们 用 整数 N 
作 参 数 ， 从 本 质 上 来 说 ， 它 们 不 让 Observable 发 射 前 N 个 或 者 后 N 个 值 。 如 果 我 们 
知道 一 个 序列 以 没有 太 多 用 的 “可 控 " 元 素 开头 或 结尾 时 我 们 可 以 使 用 它 。 


下 图 与 前 一 个 场景 相对 应 : 我 们 创建 一 个 新 的 序列 ， 它 会 跳 过 后 面 两 个 元 素 从 源 序 
列 中 发 射 剩 下 的 其 他 元 素 。 
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skipLast(2) 
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ElementAt 


如 果 我 们 只 想 要 可 观测 序列 发 射 的 第 五 个 元 素 该 怎么 办 9? elementat() 函数 仅 从 
一 个 序列 中 发 射 第 n 个 元 素 然 后 就 完成 了 。 


如 果 我 们 想 查 找 第 五 个 元 素 但 是 可 观测 序列 只 有 三 个 元 素 可 供 发 射 时 该 怎么 办 ?我 
们 可 以 使 用 elementAtorDefault() 。 下 图 展示 了 如 何 通过 使 

用 elementAt(2) 从 一 个 序列 中 选择 第 三 个 元 素 以 及 如 何 创建 一 个 只 发 射 指 定 元 
素 的 新 的 Observable ° 
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elementAt (2) 
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Sampling 


让 我 们 再 回 到 那个 温度 传感器 。 它 每 秒 都 会 发 射 当 前 室内 的 温度 。 说 实话 ， 我 们 并 
不 认为 温度 会 变化 这 么 快 ， 我 们 可 以 使 用 一 个 小 的 发 射 间隔 。 在 Observable 后 面 加 
一 个 sample() ， 我 们 将 创建 一 个 新 的 可 观测 序列 ， 它 将 在 一 个 指定 的 时 间 间 隔 里 
由 Observable 发 射 最 近 一 次 的 数值 : 


Observable<Integer> sensor = [...] 


sensor.sample(30, TimeUnit .SECONDS ) 
.subscribe(new Observer<Integer>() { 


@Override 
public void onCompleted() { 


@Override 
public void onError(Throwable e) { 


@Override 
public void onNext(Integer currentTemperature) { 
updateDisplay(currentTemperature) 


5H); 


例子 中 Observable 将 会 观测 温度 Observable 然 后 每 隔 30 秒 就 会 发 射 最 后 一 个 温度 
值 。 很 明显 ， sample() 支持 全 部 的 时 间 单 位 : 秒 ， 毫 秒 ， 天 ， 分 等 等 。 


下 图 中 展示 了 一 个 间隔 发 射 字母 的 Observable 如 何 采 样 一 个 发 射 数字 的 
Observable。Observable 的 结果 将 会 发 射 每 个 已 发 射 字 母 的 最 后 一 组 数据 : 1，4， 
5. 


Sampling 


sample 


如 果 我 们 想 让 它 定 时 发 射 第 一 个 元 素 而 不 是 最 近 的 一 个 元 素 ， 我 们 可 以 使 
用 throttleFirst() ° 
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Timeout 


假设 我 们 工作 的 是 一 个 时 效 性 的 环境 ， 我 们 温度 传感器 每 秒 都 在 发 射 一 个 温度 值 。 
我 们 想 让 它 每 隔 两 秒 至 少 发 射 一 个 ， 我 们 可 以 使 用 timeout() 函数 来 监听 源 可 观 
测序 列 ,就 是 在 我 们 设 定 的 时 间 间 隔 内 如 果 没 有 得 到 一 个 值 则 发 射 一 个 错误 。 我 们 可 
以 认为 timeout() 为 一 个 Observable 的 限时 的 副本 。 如 果 在 指定 的 时 间 间 隔 内 
Observable 不 发 射 值 的 话 ， 它 监听 的 原始 的 Observable 时 就 会 触发 onError() $ 


Subscription subscription = getCurrentTemperature() 
. timeout (2, TimeUnit. SECONDS) 
.subscribe(new Observer<Integer>() { 


@Override 
public void onCompleted() { 


@Override 
public void onError(Throwable e) { 
Log. d("RXJAVA","You should go check the sensor, dude" 


@Override 
public void onNext (Integer currentTemperature) { 
updateDisplay(currentTemperature) 


和 sample() —# > timeout() 使 用 Timeunit 对 象 来 指定 时 间 间 隔 。 


下 图 中 展示 了 一 旦 Observable 起 过 了 限时 就 会 触发 onError() BB: 因为 超时 后 
它 才 到 达 ， 所 以 最 后 一 个 元 素 将 不 会 发 射出 去 。 





Debounce 


debounce() 函数 过 滤 掉 由 Observable 发 射 的 速率 过 快 的 数据 ; 如 果 在 一 个 指定 
的 时 间 间 隔 过 去 了 仍旧 没有 发 射 一 个 ， 那 么 它 将 发 射 最 后 的 那个 。 

就 像 sample() 和 timeout() BH > debounce() 使 用 Timeunit 对 象 指 
定时 间 间 隔 。 

下 图 展示 了 多 久 从 Observable 发 射 一 次 新 的 数据 ，debounce() 芳 数 开启 一 个 内 
部 定时 器 ， 如 果 在 这 个 时 间 间 隔 内 没有 新 的 数据 发 射 ， 则 新 的 Observable 发 射出 最 
后 一 个 数据 : 
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OA 
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这 一 章 中 ， 我 们 学 习 了 如 何 过 滤 一 个 可 观测 序列 。 我 们 现在 可 以 使 

用 filter() > skip() ， 和 sample() 来 创建 我 们 想 要 的 Observable ° 

下 一 章 中 ， 我 们 将 学 习 如 何 转换 一 个 序列 ， 将 函数 应 用 到 每 个 元 素 ， 给 它们 分 组 和 
扫描 来 创建 我 们 所 需要 的 能 完成 目标 的 特定 Observable。 


转换 Dbservables 


在 上 一 章 中 ， 我 们 探索 了 RxJava 通 用 过 滤 方 法 。 我 们 学 习 了 如 何 使 

用 filter() 方法 过 滤 我 们 不 需要 的 值 ， 如 何 使 用 take() 得 到 发 射 元 素 的 子 
集 ， 如 何 使 用 distinct() 函数 来 去 除 重 复 的 。 我 们 学 习 了 如 何 借 

Bh timeout() ， sample() ， 以 及 debounce() 来 利用 时 间 。 


这 一 章 中 ， 我 们 将 通过 学 习 如 何 变换 可 观测 序列 来 创建 一 个 能 够 更 好 的 满足 我 们 需 
求 的 序列 。 


* = 人、 三 
map 乐 话 
RxJavade ft 7 JL mapping & 
数 : map() , flatMap() , concatMap() , flatMapIterable() 以 
及 switchMap() .所 有 这 些 函 数 都 作用 于 一 个 可 观测 序列 ， 然 后 变换 它 发 射 的 值 ， 
最 后 用 一 种 新 的 形式 返回 它们 。 让 我 们 用 合适 的 “ 丨 实 世 界 ” 的 例子 一 个 个 的 学 习 
Fe 
Map 
RxJava 的 map 函数 接收 一 个 指定 的 Func 对 象 然后 将 它 应 用 到 每 一 个 由 


Observable 发 射 的 值 上 。 下 图 展示 了 如 何 将 一 个 乘法 函数 应 用 到 每 个 发 出 的 值 上 以 
此 创建 一 个 新 的 Observable 来 发 射 转换 的 数据 。 


—@@ o 


map(x => 10 * x) 


—__@-@—__@—___++ 








考虑 下 我 们 已 安装 的 应 用 列表 。 我 们 怎么 才能 够 显示 同样 的 列表 ， 但 是 又 要 所 有 的 
名 字 都 小 写 呢 ? 


我 们 的 loadList() 函数 可 以 改 成 这 样 : 


private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 
Observable.from(apps) 
.map (new Funci<AppInfo,AppInfo>()f 
@Override 
public Appinfo call(AppInfo appInfo){ 
String currentName = appInfo.getName(); 
String lowerCaseName = currentName. toLowerCase() 


appInfo. setName(lowerCaseName); 
return appInfo; 


io) 


.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity(), "Something went wr 
ong!", Toast. LENGTH SHORT) .show(); 
mSwipeRefreshLayout.setRefreshing(false); 


@Override 

public void onNext(AppInfo appInfo) { 
mAddedApps .add(appInfo); 
mAdapter.addApplication(mAddedApps.size() - 1,ap 


正如 你 看 到 的 ， 像 往常 一 样 创建 我 们 发 射 的 Observable 之 后 ， 我 们 追加 一 
个 map 调用 ， 我 们 创建 一 个 简单 的 函数 来 更 新 AppInfo 对 象 并 提供 一 个 名 字 人 小 
写 的 新 版 本 给 观察 者 。 


FlatMap 


在 复杂 的 场景 中 ， 我 们 有 一 个 这 样 的 Observable : 它 发 射 一 个 数据 序列 ， 这 些 数据 
本 身 也 可 以 发 射 Observable。RxJava 的 flatMap() 函数 提供 一 种 铺 平 序列 的 方 
式 ， 然 后 合并 这 些 Observables 发 射 的 数据 ， 最 后 将 合并 后 的 结果 作为 最 终 的 
Observable ° 








当 我 们 在 处 理 可 能 有 大 量 的 Observables 时 ， 重 要 是 记 住 任何 一 个 Observables 发 生 
错误 的 情况 ，flatMap() 将 会 触发 它 自己 的 onError() 函数 并 放弃 整个 链 。 


重要 的 一 点 提示 是 关于 合并 部 分 : 它 允 许 交 又 。 正 如 上 图 所 示 ， 这 意味 
着 flatMap() 不 能 够 保证 在 最 终生 成 的 Observable 中 源 Observables 确 切 的 发 射 
顺序 。 


ConcatMap 


RxJava 的 concatMap() BAERT flatMap() 的 交叉 问题 ， 提 供 了 一 种 能 够 把 
发 射 的 值 连续 在 一 起 的 铺 平 函数 ， 而 不 是 合并 它们 ， 如 下 图 所 示 : 





FlatMaplterable 


作为 *map 家 族 的 一 员 ， flatMapInterable() 和 flatMap() 很 像 。 仅 有 的 本 质 
不 同 是 它 将 源 数据 两 两 结 成 对 并 生成 lterable， 而 不 是 原始 数据 项 和 生成 的 
Observables。 





SwitchMap 


如 下 图 所 示 ， switchMap() 和 flatMap() 很 像 ， 除 了 一 点 : 每 当 源 Observable 
发 射 一 个 新 的 数据 项 (Observable) 时 ， 它 将 取消 订阅 并 停止 监视 之 前 那个 数据 项 
产生 的 Observable， 并 开始 监视 当前 发 射 的 这 一 个 。 





Scan 


RxJava 的 scan() HAT AAE NRI BAe scan() 函数 对 原始 
Observable 发 射 的 每 一 项 数据 都 应 用 一 个 函数 ， 计 算出 函数 的 结果 值 ， 并 将 该 值 填 
充 回 可 观测 序列 ， 等 待 和 下 一 次 发 射 的 数据 一 起 使 用 。 


作为 一 个 通用 的 例子 ， 给 出 一 个 累加 器 : 


Observable.just(1,2,3,4,5) 


.sca 
‚sub 


n((sum, item) -> sum + item) 
scribe(new Subscriber<Integer>() { 
@Override 
public void onCompleted() { 
Log.d("RXJAVA", "Sequence completed."); 


@Override 
public void onError(Throwable e) { 
Log.e("RXJAVA", "Something went south!"); 


@Override 
public void onNext(Integer item) { 
Log.d("RXJAVA", "item is: " + item); 


} 
3); 
我 们 得 到 的 结果 是 : 
RXJAVA: item is: 1 
RXJAVA: item is: 3 
RXJAVA: item is: 6 
RXJAVA: item is: 10 
RXJAVA: item is: 15 
RXJAVA: Sequence completed. 


我 们 也 可 以 创建 一 个 新 版 本 的 loadList() 函数 用 来 比较 每 个 安装 应 用 的 名 字 从 
而 创建 一 个 名 字 长 度 递增 的 列表 。 


private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 
Observable.from(apps) 
.scan((appInfo,appInfo2) -> { 
if (appInfo.getName().length > appInfo2.getName( ) 
„length()){ 
return appInfo; 
+ else { 
return appInfo2; 


3) 
.distinct() 


.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity(), "Something wen 
t wrong!", Toast.LENGTH SHORT).show(); 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onNext (AppInfo appInfo) { 
mAddedApps.add(appInfo); 
mAdapter.addApplication(mAddedApps.size() - 1 
‚appInfo); 


* OO Pa & 1807 


RxJava Essentials 


EY 9GAG 


WS AirDroid 


图 Andlytics 


5 Authenticator 


© Device Manager 


A ES File Explorer 





有 一 个 scan() 兄 数 的 变 体 ， 它 用 初始 值 作为 第 一 个 发 射 的 值 ， 方 法 签名 看 起 来 
像 : scan(R,Func2) ， 如 下 图 中 的 例子 这 样 : 





GroupBy 


拿 第 一 个 例子 开始 ， 我 们 安装 的 应 用 程序 列表 按照 字母 表 的 顺序 排序 。 然 而 ， 如 果 
现在 我 们 想 按照 最 近 更 新 日 期 来 排序 我 们 的 App 时 该 怎么 办 ? RxJava 提 供 了 一 个 有 
用 的 函数 从 列表 中 按照 指定 的 规则 : groupBy() 来 分 组 元 素 。 下 图 中 的 例子 展示 
了 groupBy() 如 何 将 发 射 的 值 根据 他 们 的 形状 来 进行 分 组 。 





这 个 函数 将 源 Observable 变 换 成 一 个 发 射 Observables 的 新 的 Observable。 它 们 中 
的 每 一 个 新 的 Observable 都 发 射 一 组 指定 的 数据 。 


为 了 创建 一 个 分 组 了 的 已 安装 应 用 列表 ， 我 们 在 loadList() 部 数 中 引入 了 一 个 
新 的 元 素 : 


Observable<GroupedObservable<String, AppInfo>> groupedItems = Obs 
ervable. from(apps) 
. groupBy (new Funci<AppInfo, String>(){ 
@Override 
public String call(AppInfo appInfo){ 
SimpleDateFormat formatter = new SimpleDateFormat ("M 
M/yyyy"); 
return formatter.format(new Date(appInfo.getLastUpda 
teTime())); 
} 
3); 


现在 我 们 创建 了 一 个 新 的 Observable， groupeditems ， 它 将 会 发 射 一 个 带 

有 Groupedobservable 的 序列 。 Groupedobservable 是 一 个 特殊 的 
Observable， 它 源 自 一 个 分 组 的 key。 在 这 个 例子 中 ，key 就 是 String ， 代 表 的 
意思 是 Month/Year 格式 化 的 最 近 更 新 日 期 。 


这 一 点 ， 我 们 已 经 创建 了 几 个 发 射 AppInfo 数据 的 Observable， 用 来 填充 我 们 的 
列表 。 我 们 想 保留 字母 排序 和 分 组 排序 。 我 们 将 创建 一 个 新 的 Observable 将 所 有 的 
联系 起 来 ， 像 往常 一 样 然后 订阅 它 : 


Observable.concat (groupedItems) 
.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity(), "Something went wrong!" 
, Toast. LENGTH SHORT).show(); 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onNext(AppInfo appInfo) { 
mAddedApps.add(appinfo); 
mAdapter .addApplication(mAddedApps.size() - 1,appInf 
0); 


Pa 


我 们 的 loadList() 函数 完成 了 ， 结 果 
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Buffer 


RxJava 中 的 buffer() #414 RObservable E 4% — 1% 49 Observable > 3X 47 4) 
Observable 每 次 发 射 一 组 列表 值 而 不 是 一 个 一 个 发 射 。 





上 图 中 展示 了 buffer() 如 何 将 count 作为 一 个 参数 来 指定 有 多 少数 据 项 被 包 在 
发 射 的 列表 中 。 实 际 上 ， buffer() 函数 有 几 种 变 体 。 其 中 有 一 个 是 允许 你 指定 一 
个 skip 值 : 此 后 每 skip 项 数据 ， 然 后 又 用 count 项 数据 填充 缓冲 区 。 如 下 图 所 


小 








3 ff ~ 
DUTTE! 


buffer() 带 一 个 timespan 的 参数 ， 会 创建 一 个 每 隔 timespan 时 间 段 就 会 发 射 
一 个 列表 的 Observable ° 





Window 


RxJava 的 window() 函数 和 buffer() 很 像 ， 但 是 它 发 射 的 是 Observable 而 不 是 
列表 。 下 图 展示 了 window() 如 何 缓 存 3 个 数据 项 并 把 它们 作为 一 个 新 的 
Observable 发 射出 去 。 








这 些 Observables 中 的 每 一 个 都 发 射 原始 Observable 数 据 的 一 个 子 集 ， 数 量 
由 count 指定 ,最 后 发 射 一 个 onCompleted() 结束 。 正 如 buffer() 一 
样 ，window() 也 有 一 个 skip 变 体 , 如 下 图 所 示 : 





Cast 


RxJava 的 cast() 函数 是 本 章 中 最 后 一 个 操作 符 。 它 是 map() 操作 符 的 特殊 版 
本 。 它 将 源 Observable 中 的 每 一 项 数据 都 转换 为 新 的 类 型 ， 把 它 变 成 了 不 同 
的 Class ° 
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这 一 章 中 ， 我 们 学 习 了 RxJava 时 如 何 控制 和 转换 可 观测 序列 。 用 我 们 现在 所 学 的 知 
识 ， 我 们 可 以 创建 、 过 滤 、 转 换 我 们 所 想 要 的 任何 种 类 的 可 观测 序列 。 

下 一 章 ， 我 们 将 学 习 如 何 组 合 Observable， 合 并 它们 ， 连 接 它们 ， 再 或 者 打包 它 
们 。 


组 合 Observables 


上 一 章 中 ， 我 们 学 到 如 何 转换 可 观测 序列 。 我 们 也 看 到 
了 map() , scan() , groupBY() ,以 及 更 多 有 用 的 函数 的 实际 例子 ， 它 们 帮助 我 
们 操作 Observable 来 创建 我 们 想 要 的 Observable。 


本 章 中 ， 我 们 将 研究 组 合 函 数 并 学 习 如 何 同 时 处 理 多 个 Observables 来 创建 我 们 想 
要 的 Observable。 


Merge 


在 ?异步 的 世界 “中 经 常会 创建 这 样 的 场景 ， 我 们 有 多 个 来 源 但 是 又 只 想 有 一 个 结 
KR: 多 输入 ， 单 输出 。RxJava 的 merge() 方法 将 帮助 你 把 两 个 其 至 更 多 的 
Observables 合 并 到 他 们 发 射 的 数据 项 里 。 下 图 给 出 了 把 两 个 序列 合并 在 一 个 最 终 
发 射 的 Observable。 


merge 


正如 你 看 到 的 那样 ， 发 射 的 数据 被 交叉 合并 到 一 个 DObservable 里 面 。 注 意 如 果 你 同 
步 的 合并 Observable， 它 们 将 连接 在 一 起 并 且 不 会 交 又 。 


像 往 常 一 样 ， 我 们 用 我 们 的 App 和 已 安装 的 App 列 表 来 创建 了 一 个 “ 丨 实 世 界 ” 的 例 
子 。 为 此 我 们 还 需要 第 二 个 Observable。 我 们 可 以 创建 一 个 单独 的 应 用 列表 然后 让 
它 逆序 排列 。 当 然 这 没有 实际 的 意义 ， 只 是 为 了 这 个 例子 。 对 于 第 二 个 列表 ， 我 们 
的 loadList() SRT MAR : 


private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 
List reversedApps = Lists.reverse(apps); 
Observable<AppInfo> observableApps =0Observable.from(apps); 
Observable<AppInfo> observableReversedApps =Observable.from( 
reversedApps) ; 
Observable<AppInfo> mergedObserbable = Observable.merge(obse 
rvableApps, observableReversedApps) ; 


mergedObserbable.subscribe(new Observer<AppInfo>() { 
@Override 
public void onCompleted() { 
mSwipeRefreshLayout. setRefreshing(false); 
Toast.makeText(getActivity(), "Here is the list!", T 
oast. LENGTH LONG) . show() ; 


} 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity(), "One of the two Observ 
able threw an error!", Toast.LENGTH SHORT).show(); 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 

public void onNext(AppInfoappInfo) { 
mAddedApps.add(appinfo); 
mAdapter .addApplication(mAddedApps.size() - 1, appIn 


我 们 创建 了 Observable 和 observableApps 数 据 项 以 及 新 的 
observableReversedAppsië A 7] Š% ° 4E Observable.merge() ， 我 们 可 以 创建 
新 的 Observable Mergedobservable ， 它 在 单个 可 观测 序列 中 发 射 源 
Observables 发 出 的 所 有 数据 。 


正如 你 能 看 到 的 ,每 个 方法 签名 都 是 一 样 的 ， 因 此 我 们 的 观察 者 无 需 在 意 任 何不 同 就 
可 以 复 用 代码 。 结 果 如 下 : 
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注意 错误 时 的 toast 消 息 ， 你 可 以 认为 每 个 Dbservable 抛 出 的 错误 都 将 会 打 断 合并 。 
如 果 你 需要 避免 这 种 情况 ，RxJava 提 供 了 mergeDelayError() ， 它 能 从 一 个 
Observable 中 继续 发 射 数据 即便 是 其 中 有 一 个 抛 出 了 错误 。 当 所 有 的 Observables 
都 完成 时 ， mergeDelayError() 将 会 发 射 onError() ， 如 下 图 所 示 : 


mergeDelayError - 





ZIP 


在 一 种 新 的 可 能 场景 中 处 理 多 个 数据 来 源 时 会 带 来 : 多 从 个 Observables 接 收 数 

据 ， 处 理 它们 ， 然 后 将 它们 合并 成 一 个 新 的 可 观测 序列 来 使 用 。RxJava 有 一 个 特殊 
的 方法 可 以 完成 : zip() 合并 两 个 或 者 多 个 Observables 发 射出 的 数据 项 ， 根 据 指 
定 的 函数 Func* 变换 它们 ， 并 发 射 一 个 新 值 。 下 图 展示 了 zip) 方法 如 何 处 理 
发 射 的 “numbers” 和 "letters” 然 后 将 它们 合并 一 个 新 的 数据 项 : 





Zip 


对 于 “ 丨 实 世 界 " 的 例子 来 说 ， 我 们 将 使 用 已 安装 的 应 用 列表 和 一 个 新 的 动态 的 
Observable 来 让 例子 变 得 有 点 有 趣味 。 


Observable<Long> tictoc = Observable.interval(i, TimeUnit.SECOND 
S); 


tictoc Observable | &14% A interval() 函数 每 秒 生成 一 个 Long 类 型 的 数据 : 
虽 简 单 但 有 效 ， 正 如 之 前 所 说 的 ， 我 们 需要 一 个 Func 对 象 。 因 为 它 需要 传 两 个 参 
数 ， 所 以 是 Func? : 


private AppInfo updateTitle(AppInfoappInfo, Long time) { 
appInfo.setName(time + " " + appInfo.getName()); 
return appInfo; 


现在 我 们 的 loadList() 函数 变 成 这 样 : 


private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 
Observable<AppInfo> observableApp = Observable.from(apps); 


Observable<Long> tictoc = Observable. interval(1, TimeUnit.SE 
CONDS); 


Observable.zip(observableApp, tictoc, 
(AppInfo appInfo, Long time) -> updateTitle(appInfo, time)) 
.observeOn(AndroidSchedulers.mainThread() ) 
.subscribe(new Observer<AppInfo>() { 
@Override 
public void onCompleted() { 
Toast.makeText(getActivity(), "Here is the list!", T 
oast. LENGTH LONG).show(); 


} 


@Override 
public void onError(Throwable e) { 
mSwipeRefreshLayout.setRefreshing(false); 
Toast .makeText (getActivity(), "Something went wrong!" 
, Toast.LENGTH_SHORT).show(); 


} 


@Override 
public void onNext(AppInfoappInfo) { 
if (mSwipeRefreshLayout.isRefreshing()) { 
mSwipeRefreshLayout.setRefreshing(false); 
} 
mAddedApps.add(appInfo); 
int position = mAddedApps.size() - 1; 
mAdapter .addApplication(position, appInfo); 
mRecyclerView.smoothScrollToPosition(position); 


3); 








正如 你 看 到 的 那样 ， zip) 函数 有 三 个 参数 : 两 个 Dbservables 和 一 个 Func2 ° 


仔细 一 看 会 发 现 observeon() 函数 。 它 将 在 下 一 章 中 讲解 : 现在 我 们 可 以 小 试 一 
下 o 


结果 如 下 : 
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Join 


前 面 两 个 方法 ， zip() 和 merge() 方法 作用 在 发 射 数据 的 范畴 内 ， 在 决定 如 何 
操作 值 之 前 有 些 场景 我 们 需要 考虑 时 间 的 。RxJava 的 join() 函数 基于 时 间 窗 口 
将 两 个 Observables 发 射 的 数据 结合 在 一 起 。 





为 了 正确 的 理解 上 一 张 图 ， 我 们 解释 下 join() 需要 的 参数 : 


e 第 二 个 Observable 和 源 Observable 结 合 。 

e Funci 参数 : 在 指定 的 由 时 间 窗 口 定义 时 间 间 隔 内 ， 源 Observable 发 射 的 数 
据 和 从 第 二 个 Observable 发 射 的 数据 相互 配合 返回 的 Observable。 

e Funci 参数 : 在 指定 的 由 时 间 窗 口 定 义 时 间 间 隔 内 ， 第 二 个 Observable 发 射 
的 数据 和 从 源 Observable 发 射 的 数据 相互 配合 返回 的 Observable。 

e Func2 参数 : 定义 已 发 射 的 数据 如 何 与 新 发 射 的 数据 项 相 结合 。 

e 如 下 练习 的 例子 ， 我 们 可 以 修改 loadList() 函数 像 下 面 这 样 : 


private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 


Observable<AppInfo> appsSequence = 
Observable. interval(1000, TimeUnit .MILLISECONDS) 


.map(position -> { 
return apps.get(position.intValue()); 


+); 


Observable<Long> tictoc = Observable.interval(i000, TimeUni 
t.MILLISECONDS) ; 


appsSequence. join( 

tictoc, 
appInfo -> Observable.timer(2, TimeUnit.SECONDS), 
time -> Observable.timer(0, TimeUnit.SECONDS), 
this: :updateTitle) 
.observeOn(AndroidSchedulers.mainThread( ) ) 
. take(10) 
.subscribe(new Observer<AppInfo>() { 

@Override 

public void onCompleted() { 

Toast .makeText (getActivity(), "Here is the lis 
t!", Toast.LENGTH_LONG).show(); 


} 


@Override 
public void onError(Throwable e) { 
mSwipeRefreshLayout.setRefreshing(false); 
Toast .makeText(getActivity(), "Something went 
wrong!", Toast.LENGTH_SHORT).show(); 


} 


@Override 

public void onNext(AppInfoappInfo) { 
if (mSwipeRefreshLayout.isRefreshing()) { 

mSwipeRefreshLayout.setRefreshing(false); 

} 
mAddedApps.add(appInfo); 
int position = mAddedApps.size() - 1; 
mAdapter.addApplication(position, appInfo); 
mRecyclerView. smoothScrollToPosition( position) 


iy, 


我 们 有 一 个 新 的 对 象 appssequence ， 它 是 一 个 每 秒 从 我 们 已 安装 的 app 列 表 发 射 
app 数 据 的 可 观测 序列 。 tictoc 这 个 Observable 数 据 每 秒 只 发 射 一 个 新 
的 Long 型 整数 。 为 了 合并 它们 ， 我 们 需要 指定 两 个 Funct EE: 


appInfo -> Observable.timer(2, TimeUnit.SECONDS) 


time -> Observable.timer(0, TimeUnit.SECONDS) 


上 面 描述 了 两 个 时 间 窗 口 。 下 面 一 行 描 述 我 们 如 何 使 用 Func2 将 两 个 发 射 的 数据 
结合 在 一 起 。 


this::updateTitle 


结果 如 下 : 
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它 看 起 来 有 点 乱 ， 但 是 注意 app 的 名 字 和 我 们 指定 的 时 间 窗 口 ， 我 们 可 以 看 到 : 一 
旦 第 二 个 数据 发 射 了 我 们 就 会 将 它 与 源 数据 结合 ， 但 我 们 用 同一 个 源 数据 有 2 秒 


钟 。 这 就 是 为 什么 标题 重复 数字 增加 的 原因 。 
值得 一 提 的 是 ， 为 了 简单 起 见 ， 也 有 一 个 join() 操作 符 作用 于 字符 囊 然后 简单 的 
fo RAE EAE BEAR RAH PAE 





了 


"E+Pluribus+Unum” 





combineLatest 


RxJava 的 combineLatest() 函数 有 点 像 zip) 有 函数 的 特殊 形式 。 正 如 我 们 已 经 
学 习 的 ， zip() 作用 于 最 近 未 打包 的 两 个 Observables。 相 

B> combineLatest() 作用 于 最 近 发 射 的 数据 项 : 如 果 0bservablel RATA 
并 且 Observable2 发 射 了 B 和 C， combineLatest() 将 会 分 组 处 理 AB 和 AC， 如 
下 图 所 示 : 


一 他 O ———OOO+ 


—0 0 969- + 


combineLatest((x, y) => "" + x + y) 


— 000 0000 0 


combineLatest() 函数 接受 二 到 九 个 Dbservable 作 为 参数 ， 如 果 有 需要 的 话 或 者 
单个 Observables 列 表 作 为 参数 。 





从 之 前 的 例子 中 把 loadList() 函数 借用 过 来 ， 我 们 可 以 修改 一 下 来 用 
于 combineLatest() EM É RBA PIF: 


private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 
Observable<AppInfo> appsSequence = Observable. interval(1000, 
TimeUnit .MILLISECONDS ) 
.map(position ->apps.get(position.intValue())); 
Observable<Long> tictoc = Observable. interval(1500, TimeUnit 
„MILLISECONDS) ; 
Observable.combineLatest (appsSequence, tictoc, 
this: :updateTitle) 
.observeOn(AndroidSchedulers.mainThread() ) 
.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 
Toast .makeText(getActivity(), "Here is the list!", T 
oast.LENGTH_LONG).show(); 


} 


@Override 
public void onError(Throwable e) { 





mSwipeRefreshLayout.setRefreshing(false); 


Toast .makeText (getActivity(), "Something went wrong!" 


, Toast.LENGTH_SHORT).show(); 
} 


@Override 
public void onNext(AppInfoappInfo) { 
if (mSwipeRefreshLayout. isRefreshing()) { 
mSwipeRefreshLayout. setRefreshing(false); 
} 
mAddedApps.add(appInfo); 
int position = mAddedApps.size() - 1; 
mAdapter .addApplication(position, appInfo); 
mRecyclerView.smoothScrollToPosition(position); 


5); 





b 





这 我 们 使 用 了 两 个 Observables : 一 个 是 每 秒 钟 从 我 们 已 安装 的 应 用 列表 发 射 一 个 
App 数 据 ， 第 二 个 是 每 隔 1.5 秒 发 射 一 个 Long 型 整数 。 我 们 将 他 们 结合 起 来 并 执 
行 updateTitle() 函数 ， 结 果 如 下 : 





O 9GAG 


10 Alert 


多 10Alert 


a 1 Amazon Deal 
Zoe Browser 


A 2 1 Assist 


k 2 1 Assist 








正如 你 看 到 的 ， 由 于 不 同 的 时 间 间 隔 ， AppInfo 对 象 如 我 们 所 预料 的 那样 有 时 候 
会 重复 。 


And,Thení When 


在 将 来 还 有 一 些 zip() 满足 不 了 的 场景 。 如 复杂 的 架构 ， 或 者 是 仅仅 为 了 个 人 爱 
好 ， 你 可 以 使 用 And/Then/When 解 决 方案 。 它 们 在 RxJava 的 joins 包 下 ， 使 用 
Pattern 和 Plan 作为 中 介 ， 将 发 射 的 数据 集合 并 到 一 起 。 


Y 





我 们 的 loadList() 函数 将 会 被 修改 从 这 样 : 
private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 
Observable<AppInfo> observableApp = Observable.from(apps); 


Observable<Long> tictoc = Observable. interval(1, TimeUnit.SE 
CONDS); 


Pattern2<AppInfo, Long> pattern = JoinObservable.from(observ 
ableApp).and(tictoc); 


PlanO<AppInfo> plan = pattern.then(this::updateTitle) ; 


JoinObservable 
„when (plan) 
. toObservable() 
.observeOn(AndroidSchedulers.mainThread() ) 
.subscribe(new Observer<AppInfo>() { 


@Override 
public void onCompleted() { 


Toast.makeText(getActivity(), "Here is the list!" 


, TOast.LENGTH_LONG).show(); 
} 


@Override 
public void onError(Throwable e) { 
mSwipeRefreshLayout.setRefreshing(false); 
Toast .makeText (getActivity(), "Something went wr 
ong!", Toast.LENGTH_SHORT).show(); 


} 


@Override 
public void onNext(AppInfoappInfo) { 
if (mSwipeRefreshLayout.isRefreshing()) { 
mSwipeRefreshLayout.setRefreshing(false); 
} 
mAddedApps .add(appInfo); 
int position = mAddedApps.size() - 1; 
mAdapter .addApplication(position, appInfo); mRec 
yclerView.smoothScrollToPosition(position); 


} 
3); 





b 





和 通常 一 样 ， 我 们 有 两 个 发 射 的 序列 ， observableapp ， 发 射 我 们 安装 的 应 用 列 
表 数 据 ， tictoc 每 秒 发 射 一 个 Long 型 整数 。 现 在 我 们 用 and() 连接 源 
Observable 和 第 二 个 Observable ° 


JoinObservable.from(observableApp).and(tictoc); 


这 里 创建 一 个 pattern 对 象 ， 使 用 这 个 对 象 我 们 可 以 创建 一 个 Plan 对 象 :" 我 们 
有 两 个 发 射 数据 的 Observables，then() 是 做 什么 的 ?" 


pattern.then(this::updateTitle); 


现在 我 们 有 了 一 个 Plan 对 象 并 且 当 plan 发 生 时 我 们 可 以 决定 接 下 来 发 生 的 事情 。 


.when(plan) .toObservable( ) 


这 时 候 ， 我 们 可 以 订阅 新 的 Observable， 正 如 我 们 总 是 做 的 那样 。 


Switch 


有 这 样 一 个 复杂 的 场景 就 是 在 一 个 subscribe-unsubscribe 的 序列 里 我 们 能 够 从 
一 个 Observable 自 动 取消 订阅 来 订阅 一 个 新 的 Observable。 


RxJava 的 switch() ， 正 如 定义 的 ， 将 一 个 发 射 多 个 Observables 的 Observable 转 
换 成 另 一 个 单独 的 Observable， 后 者 发 射 那些 Observables 最 近 发 射 的 数据 项 。 


给 出 一 个 发 射 多 个 Observables 序 列 的 源 Observable， switch() 订阅 到 源 
Observable 然 后 开始 发 射 由 第 一 个 发 射 的 Observable 发 射 的 一 样 的 数据 。 当 源 
Observable 发 射 一 个 新 的 Observable 时 ， switch() 立即 取消 订阅 前 一 个 发 射 数 
据 的 Observable (因此 打 断 了 从 它 那 里 发 射 的 数据 流 ) 然后 订阅 一 个 新 的 
Observable， 并 开始 发 射 它 的 数据 。 





StartWith 


我 们 已 经 学 到 如 何 和 连接 多 个 Observables 并 追加 指定 的 值 到 一 个 发 射 序列 里 。 
RxJava 的 startwith() 是 concat() 的 对 应 部 分 。 正 如 concat() 向 发 射 数据 
的 Observable 追 加 数据 那样 ， 在 Observable 开 始 发 射 他 们 的 数据 之 前 ， 
startwith() 通过 传递 一 个 参数 来 先 发 射 一 个 数据 序列 。 





ER 


Er 


~ 


这 章 中 ， 我 们 学 习 了 如 何 将 两 个 或 者 更 多 个 Observable 结 合 来 创建 一 个 新 的 可 观测 


序列 。 我 们 将 能 够 merge Observable， join Observables ， zip 

Observables 并 在 几 种 情况 下 把 他 们 结合 在 一 

ea ， 我 们 将 介绍 调度 器 ， 它 将 很 容易 的 帮助 我 们 创建 主线 程 以 及 提高 我 们 应 用 
程序 的 性 能 。 我 们 也 将 学 习 如 何 正 确 的 执行 长 任务 或 者 MO 任务 来 获得 更 好 的 性 能 。 


Schedulers- 解 决 Android 主 线程 问题 


前 面 一 章 是 最 后 一 章 关于 RxJava 的 Observable 的 创建 和 操作 的 章节 。 我 们 学 习 到 
了 如 何 将 两 个 或 更 多 的 Observables 合 并 在 一 起 ， join 它们 ， zip É 
们 ， merge 它们 以 及 如 何 创 建 一 个 新 的 Observable 来 满足 我 们 特殊 的 需求 。 


本 章 中 ， 我 们 提升 标准 看 看 如 何 使 用 RxJava 的 调度 器 来 处 理 多 线程 和 并 发 编程 的 问 
题 。 我 们 将 学 习 到 如 何以 响应 式 的 方式 创建 网 络 操作 ， 内 存 访 问 ， 以 及 耗 时 任务 。 


StrictMode 


为 了 获得 更 多 出 现在 代码 中 的 关于 公共 问题 的 信息 ， 我 们 激活 了 StrictMode A 
式 o 


StrictMode WRTA MARL E BAIA E ERRATE ET PI] A 

者 网 络 调用 。 正 如 你 所 知道 的 ， 在 主线 程 执行 繁重 的 或 者 长 时 的 任务 是 不 可 取 的 。 

因为 Android 应 用 的 主线 程 时 UI 线程 ， 它 被 用 来 处 理 和 UI 相关 的 操作 : 这 也 是 获得 
更 平滑 的 动画 体验 和 响应 式 App 的 唯一 方法 。 


为 了 在 我 们 的 App 中 激活 StrictMode ， 我 们 只 需要 在 Mainactivity 中 添加 几 
行 代码 ， 即 onCreate() 方法 中 这 样 : 


@Override 
public void onCreate() { 
super .onCreate(); 
if (BuildConfig.DEBUG) { 
StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.B 
uilder().detectAll().penaltyLog().build()); 
StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder() 
.detectAll().penaltyLog().build()); 
} 


我 们 并 不 想 BE 总 是 激活 着 ? 因此 我 们 只 在 debug 构 建 时 使 用 。 这 种 配置 将 报告 每 一 
种 关于 主线 程 用 法 的 违规 做 法 ， 并 且 这 些 做 法 都 可 能 与 ABRA 
X : Activities ` BroadcastReceivers ` Sqlite 等 对 象 。 


选择 了 penaltyLog() ， 当 违规 做 法 发 生 时 ， StrictMode 将 会 在 logcat 打 印 一 
条 信息 。 


BE e, TE WO 8) RAE 


阻塞 WO 的 操作 会 导致 App 必 须 等 待 结果 返 回 〈 阻 塞 结束 ) 才能 进行 下 一 步 操作 。 在 
UI 线程 上 执行 一 个 阻塞 操作 会 将 UI 强行 卡 住 ， 直 接 造 成 很 糟糕 的 用 户 体 验 。 


我 们 激活 StrictMode 后 ， 我 们 开始 收 到 了 关于 我 们 的 App 错 误 操作 磁盘 |/ 〇 的 不 
良 信 息 。 


D/StrictMode StrictMode policy violation; ~duration=998 ms: and 
roid.os.StrictMode$StrictModeDiskReadViolation: policy=31 violat 
ion=2 

at android.os.StrictMode$AndroidBlockGuardPolicy.onReadFromDisk 

(StrictMode.java:1135) 

at libcore.io.BlockGuardOs.open(BlockGuardOs.java:106) at libcor 
e.io. IoBridge.open(IoBridge.java:393) 

at java.io.FileOutputStream.<init>(FileOutputStream. java: 88) 

at android.app.ContextImpl.openFileOutput(ContextImpl.java:918) 

at android.content.ContextWrapper .openFileOutput(Contextwrapper. 
java:185) 

at com.packtpub.apps.rxjava_essentials.Utils.storeBitmap (Utils. 
java:30) 


条 信息 告诉 我 们 Utils.storeBitmap() AAT HAER BMS : 在 UI 线程 上 
T 这 是 因为 我 们 以 阻塞 的 方式 访 
HAA o RÉI storeBitmap() 函数 包含 


FileOutputStream fOut = context.openFileOutput (filename, Context 
„MODE PRIVATE); 


它 直 接 访问 智能 手机 的 固态 存储 然后 就 慢 了 。 我 们 该 如 何 提 高 访问 速度 

Æ? storeBitmap() 驾 数 保存 了 已 安装 App 的 图 标 。 他 的 返回 值 类 型 为 void ， 
因此 在 执行 下 一 个 操作 前 我 们 毫 无 理由 去 等 待 直到 它 完成 。 我 们 可 以 启动 它 并 让 它 
执行 在 不 同 的 线程 。 近 几 年 来 Android 的 线程 管理 发 生 了 许多 变化 ， 导 致 App 出 现 诡 


异 的 行为 。 我 们 可 以 使 用 AsyncTask ， 但 是 我 们 要 避免 掉 入 前 几 章 里 
的 onPre... onPost...doInBackGround 地 狱 。 下 面 我 们 将 换 用 RxJava 的 方 
式 。 调 度 器 万 岁 | 


Schedulers 


调度 器 以 一 种 最 简单 的 方式 将 多 线程 用 在 你 的 Apps 的 中 。 它 们 时 RxJava 重 要 的 一 
部 分 并 能 很 好 地 与 Observables 协 同 工 作 。 它 们 无 需 处 理 实现 、 同 步 、 线 程 、 平 台 
限制 、 平台 2 变化 而 可 以 提供 一 种 灵活 的 方式 来 创 建 并 发 程序 je 


RxJava 提 供 了 5 种 调度 器 : 


e .io() 

e .computation() 
e .immediate() 

e .newThread() 


e .trampoline() 


让 我 们 一 个 一 个 的 来 看 下 它们 


Schedulers.io() 


这 个 调度 器 时 用 于 MO 操作 。 它 基于 根据 需要 ， 增 长 或 缩减 来 自 适应 的 线程 池 。 我 们 
将 使 用 它 来 修复 我 们 之 前 看 到 的 StrictMode 违规 做 法 。 由 于 它 专用 于 |/O 操 作 ， 
所 以 并 不 是 RxJava 的 默认 方法 ; 正确 的 使 用 它 是 由 开发 者 决定 的 。 


重点 需要 注意 的 是 线程 池 是 无 限制 的 ， 大 量 的 MO 调度 操作 将 创建 许多 个 线程 并 占用 
内 存 。 一 如 既往 的 是 ， 我 们 需要 在 性 能 和 简捷 两 者 之 间 找 到 一 个 有 效 的 平衡 点 。 


Schedulers.computation() 
这 个 是 计算 工作 默认 的 调度 器 ， 它 与 /QO 操作 无 关 。 它 也 是 许多 RxJava 方 法 的 默认 


调度 
& : buffer() , debounce() , delay() , interval() , sample() , skip() 


o 


Schedulers.immediate() 


这 个 调度 器 允许 你 立即 在 当前 线程 执行 你 指定 的 工作 。 它 
是 timeout() , timeInterval() ,以 及 timestamp() 方法 默认 的 调度 器 。 
Schedulers.newThread() 


这 个 调度 器 正如 它 所 看 起 来 的 那样 : 它 为 指定 任务 启动 一 个 新 的 线程 。 


Schedulers.trampoline() 


sir a > 并 不 是 立即 ， 我 们 可 以 
用 .trampoline() 将 它 入 队 。 这 个 调度 器 将 会 处 理 它 的 队列 并 且 按 序 运 行 队列 中 
每 一 个 任务 。 它 是 repeat() 和 retry() 方法 默认 的 调度 器 。 


非 阻塞 /OQ 操作 


现在 我 们 知道 如 何在 一 个 指定 MO 调度 器 上 来 调度 一 个 任务 ， 我 们 可 以 修 
改 storeBitmap() BKHAARI StrictMode 的 不 合 规 做 法 。 为 了 这 个 例子 ， 
我 们 可 以 在 新 的 blockingstoreBitmap() 函数 中 重 排 代码 。 


private static void blockingStoreBitmap(Context context, Bitmap 
bitmap, String filename) { 
FileOutputStream fOut = null; 
try { 
fOut = context.openFileOutput(filename, Context .MODE_PRI 
VATE); 
bitmap.compress(Bitmap.CompressFormat.PNG, 100, fOut); 
fout.flush(); 
fOut.close(); 
} catch (Exception e) { 
throw new RuntimeException(e); 
} finally { 
ER 
if (fout != null) { 
fOut.close(); 
} 
} catch (IOException e) { 
throw new RuntimeException(e); 


现在 我 们 可 以 使 用 schedulers.io() 创建 非 阻塞 的 版 本 : 


public static void storeBitmap(Context context, Bitmap bitmap, S 
tring filename) { 
Schedulers.io().createworker().schedule(() -> { 
blockingStoreBitmap(context, bitmap, filename); 


3); 


JE PE VOLE TE 


每 次 我 们 调用 storeBitmap() ，RxJava 处 理 创 建 所 有 它 需 要 从 1/1O 线 程 池 一 个 特 
定 的 IO 线程 执行 我 们 的 任务 。 所 有 要 执行 的 操作 都 避免 在 U 线 程 执 行 并 且 我 们 的 
App 比 之 前 要 快 上 1 秒 : logcat 上 也 不 再 有 StrictMode 的 不 合 规 做 法 。 


下 图 展示 了 我 们 在 storeBitmap() 场景 看 到 的 两 种 方法 的 不 同 : 


Os Is 2s 
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SubscribeOn and ObserveOn 


我 们 学 到 了 如 何在 一 个 调度 器 上 运行 一 个 任务 。 但 是 我 们 如 何 利 用 它 来 和 
Observables 一 起 工作 呢 ? RxJava 提 供 了 subscribeon() 方法 来 用 于 每 个 
Observable 对 象 。 subscribeon() 方法 用 Scheduler 来 作为 参数 并 在 这 个 
Scheduler 上 执行 DObservable 调 用 。 


在 “ 丨 实 世 界 " 这 个 例子 中 ， 我 们 调整 1oadList() 函数 。 首 先 ， 我 们 需要 一 个 新 
的 getApps() 方法 来 检索 已 安装 的 应 用 列表 : 


private Observable<AppInfo> getApps() { 
return Observable.create(subscriber -> { 
List<AppInfo> apps = new ArrayList<>(); 
SharedPreferences sharedPref = getActivity().getPreferen 
ces(Context.MODE PRIVATE); 
Type appInfoType = new TypeToken<List<AppInfo>>(){}.getT 


ype(); 
String serializedApps = sharedPref.getString("APPS", "") 
if (!"".equals(serializedApps)) { 
apps = new Gson().fromJson(serializedApps, appInfoTyp 
e); 
} 
for (AppInfo app : apps) { 
subscriber .onNext (app); 
} 
subscriber .onCompleted(); 
5); 
} 


getApps() 方法 返回 一 个 AppInfo 的 Observable。 它 先 从 Android 的 
SharePreferences 读 取 到 已 安装 的 应 用 程序 列表 。 反 序列 化 ， 并 一 个 接 一 个 的 发 射 
Applnfo 数 据 。 使 用 新 的 方法 来 检索 列表 ， loadList() 函数 改 成 下 面 这 样 : 


private void loadList() { 
mRecyclerView.setVisibility(View.VISIBLE); 
getApps().subscribe(new Observer<AppInfo>() { 
@Override 
public void onCompleted() { 
mSwipeRefreshLayout. setRefreshing(false); 
Toast.makeText(getActivity(), "Here is the list!", T 
oast. LENGTH LONG). show(); 


} 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity(), "Something went wrong!" 
, Toast.LENGTH SHORT ).show( ); 
mSwipeRefreshLayout. setRefreshing(false); 


@Override 
public void onNext(AppInfo appInfo) { 
mAddedApps.add(appInfo); 
mAdapter .addApplication(mAddedApps.size() - 1, a 


_ JAR | 


如 果 我 们 运行 代码 ， StrictMode 将 会 报告 一 个 不 合 规 操作 ， 这 是 因 
为 SharePreferences 会 减 慢 MO 操作 。 我 们 所 需要 做 的 是 指定 getApps() 需要 
在 调度 器 上 执行 : 


getApps().subscribeOn(Schedulers.io()) 
.subscribe(new Observer<AppInfo>() { [...] 


Schedulers.io() 将 会 去 掉 StrictMode 的 不 合 规 操作 ， 但 是 我 们 的 App 现 在 崩 
溃 了 是 因为 : 


at rx.internal.schedulers.ScheduledAction.run(ScheduledAction.ja 
v a:58) 
at java.util.concurrent.Executors$RunnableAdapter.call(Executors 
. java:422) 
at java.util.concurrent.FutureTask.run(FutureTask. java: 237) 
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFut 
u reTask.access$201(ScheduledThreadPoolExecutor.java:152) 
at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFut 
u reTask.run(ScheduledThreadPoolExecutor. java: 265) 
at java.util.concurrent.ThreadPoolExecutor.runworker(ThreadPoolE 
x ecutor.java:1112) 
at java.util.concurrent.ThreadPoolExecutor$worker.run(ThreadPool 
E xecutor.java:587) 
at java. lang.Thread.run(Thread.java:341) Caused by: 

android. view. ViewRoot Impl$CalledFromwrongThreadException: On 
ly the original thread that created a view hierarchy can touch i 
ts views. 


Only the original thread that created a view hierarchy can touch its views. 


我 们 再 次 回 到 Android 的 世界 。 这 条 信息 简单 的 告诉 我 们 我 们 试图 在 一 个 非 UI 线 程 
RERUIR + EEERNEE LOM 器 上 执行 我 们 的 代码 。 因 此 我 们 需要 和 
/0 调度 器 一 起 执行 代码 ， 但 是 当 结 果 返 回 时 我 们 需要 在 U ea 。RxJava 让 
你 能 够 订阅 一 个 指 e 我 们 只 需 在 loadlist() 函数 添加 几 行 
代码 ， 那 么 每 一 项 就 都 准备 好 了 : 


getApps() 

.onBackpressureBuf fer () 

. subscribeOn(Schedulers.io()) 
.observeOn(AndroidSchedulers.mainThread( ) ) 
.subscribe(new Observer<AppInfo>() { [...] 


observeon() 方法 将 会 在 指定 的 调度 器 上 返回 结果 : 如 例子 中 的 UI 线 

程 。 onBackpressureBuffer() 方法 将 告诉 Dbservable 发 射 的 数据 如 果 比 观察 者 
消费 的 数据 要 更 快 的 话 ， 它 必须 把 它们 存储 在 缓存 中 并 提供 一 个 合适 的 时 间 给 它 
们 。 做 完 这 些 工作 之 后 ， 如 果 我 们 运行 App， 就 会 出 现 已 安装 的 程序 列表 : 


$020 04 01738 


RxJava Essentials 


EJ cos 
QO Ambio 


Andlytics 


Authenticator 


Beta 


Buffer 





SubscribeOn and ObserveOn 
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处 理 耗 时 的 任务 


我 们 已 经 知道 如 何 处 理 缓慢 的 |/O 操 作 。 让 我 们 看 一 个 与 I/ 无 关 的 耗 时 的 任务 。 例 
如 ， 我 们 修改 loadList() 函数 并 创建 一 个 新 的 slow 函数 发 射 我 们 已 安装 的 app 
数据 。 


private Observable<AppInfo> getObservableApps(List<AppInfo> apps) 
{ 


return Observable .create(subscriber -> { 
for (double i = 0; i < 1000000000; i++) { 
double y = i * i; 
} 
for (AppInfo app : apps) { 
subscriber .onNext (app); 


} 


subscriber .onCompleted(); 


}); 


正如 你 看 到 的 ， 这 个 函数 执行 了 一 些 毫 无 意义 的 计算 ， 只 是 针对 这 个 例子 消耗 时 
间 ， 然 后 从 List<AppInfo> 对 象 中 发 射 我 们 的 AppInfo 数据 ， 现 在 ， 我 们 重 
BE loadList() 函数 如 下 : 


private void loadList(List<AppInfo> apps) { 
mRecyclerView.setVisibility(View.VISIBLE); 
getObservableApps(apps) 
.subscribe(new Observer<AppInfo>() { 
@Override 
public void onCompleted() { 
mSwipeRefreshLayout.setRefreshing(false); 
Toast.makeText(getActivity(), "Here is the list!" 
, TOast.LENGTH_LONG).show(); 


} 


@Override 
public void onError(Throwable e) { 
Toast .makeText (getActivity(), "Something went wr 
ong!", Toast.LENGTH_SHORT).show(); 
mSwipeRefreshLayout.setRefreshing(false); 


@Override 

public void onNext(AppInfo appInfo) { 
mAddedApps.add(appinfo); 
mAdapter .addApplication(mAddedApps.size() - 1, a 


4 ay hl 


如 果 我 们 运行 这 上 段 代码 ’ & 81] 点 击 Navigation Drawer 菜单 项 时 App 将 会 卡 住 
一 会 ， 然 后 你 能 看 到 下 图 中 半 关 闭 的 菜 


Take and TakeLast 


Distinct abd 
DistinctUntilChanged 


Map 


Scan 


GroupBy 


Merge 


Zip 


Join 


CombineLatest 


And Then When 


SharedPreferences 


Long task 
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如 果 我 们 不 够 走运 的 话 ， 我 们 可 以 看 到 下 图 中 经 典 的 ANR 信 息 框 : 


MAIOR v 4 Q 1851 


RxJava Essentials isn't responding. 


Do you want to close it? 





可 以 确定 的 是 ， 我 们 将 会 看 到 下 面 在 logcat 中 不 愉快 的 信息 : 


I/Choreographer Skipped 598 frames! The application may be doin 
g too much work on its main thread. 


这 条 信息 比较 清楚 ，Android 在 告诉 我 们 用 户 体验 非常 差 的 原因 是 我 们 用 不 必要 的 
工作 量 阻 塞 了 UI 线 程 。 但 是 我 们 已 经 知道 了 如 何 处理 它 : 我 们 有 调度 器 ! 我 们 只 须 
添加 几 行 代码 到 我 们 的 Observable 链 中 就 能 去 掉 加 载 慢 和 Choreographer 信息 : 


getObservableApps(apps) 
.onBackpressureBuf fer () 
. subscribeOn(Schedulers.computation() ) 
.observeOn(AndroidSchedulers.mainThread() ) 
.subscribe(new Observer<AppInfo>() { [...] 


用 这 几 行 代码 ， 我 们 将 可 以 快速 关 掉 Navigation Drawer ,一 个 漂亮 的 进度 条 ， 
一 个 工作 在 独立 的 线程 缓慢 执行 的 计算 任务 ， 并 在 主线 程 返回 结果 让 我 们 更 新 已 安 
装 的 应 用 列表 。 


执行 网 络 任务 


在 当今 99% 的 移动 应 用 中 网 络 都 是 必 不 可 缺 的 一 部 分 : 总 是 需要 连接 远程 服务 器 来 


检索 App 需 要 的 信息 。 
作为 网 络 访问 的 第 一 个 案例 ， 我 们 将 创建 下 面 这 样 一 个 场景 


o 加 载 一 个 进度 条 。 

。 用 一 个 按钮 开始 文件 下 载 。 
e 下 载 过 程 中 更 新 进度 条 。 
e 下 载 完 后 开始 视频 播放 。 


我 们 的 用 户 界 面 非常 简单 ， 我 们 只 需要 一 个 有 趣 的 进度 条 和 一 个 下 载 按钮 。 


DOWNLOAD 





首先 ， 我 们 创建 mDownloadProgress 


private PublishSubject<Integer> mDownloadProgress = PublishSubje 
ct.create(); 


这 个 主题 我 们 用 来 管理 进度 的 更 新 ， 它 和 download BAHL o 


private boolean downloadFile(String source, String destination) 
{ 
boolean result = false; 
InputStream input = null; 
OutputStream output = null; 
HttpURLConnection connection = null; 
Eny 4 
URL url = new URL(source); 
connection = (HttpURLConnection) url.openConnection(); 
connection.connect(); 
if (connection.getResponseCode() != HttpURLConnection.HT 
TP_OK) { 
return false; 
} 
int fileLength = connection.getContentLength(); 
input = connection.getInputStream(); 
output = new FileOutputStream(destination); 
byte data[] = new byte[4096]; 
long total = 0; 
int count; 
while ((count = input.read(data)) != -1) { 
total += count; 
if (fileLength >0) { 
int percentage = (int) (total * 100 / fileLength 
); 
mDownloadProgress.onNext (percentage); 


} 


output.write(data, O, count); 


} 


mDownloadProgress.onCompleted(); 
result = true; 


} catch (Exception e) { 
mDownloadProgress.onError(e); 
} finally { 
ry et 
if (output != null) q 
output.close(); 
} 
if (input != null) { 
input.close(); 
3 
+ catch (IOException e) { 
mDownloadProgress.onError(e); 


} 

if (connection != null) { 
connection.disconnect(); 
mDownloadProgress.onCompleted(); 

3 


} 


return result; 


上 面 的 这 段 代码 将 会 触发 NetworkonMainThreadException 异常 。 我 们 可 以 创建 
RxJava 版 本 的 函数 进入 我 们 挚爱 的 响应 式 世 界 来 解决 这 个 问题 : 


private Observable<Boolean> obserbableDownload(String source, St 
ring destination) { 
return Observable.create(subscriber -> { 
try { 
boolean result = downloadFile(source, destination); 
if (result) { 
subscriber .onNext(true); 
subscriber .onCompleted(); 
+ else { 
subscriber .onError (new Throwable("Download faile 


d.")); 
} 
} catch (Exception e) { 
subscriber .onError(e); 
} 
3); 
Je 


现在 我 们 需要 触发 下 载 操作 ， 点 击 下 载 按钮 : 


@OnClick(R.id.button download) 

void download() { 
mButton.setText(getString(R.string.downloading)); 
mButton.setClickable( false); 
mDownloadProgress.distinct() 
.observeOn(AndroidSchedulers.mainThread() ) 
.subscribe(new Observer<Integer>() { 


@Override 
public void onCompleted() { 
App.L.debug("Completed"); 


@Override 
public void onError(Throwable e) { 
App.L.error(e.toString()); 


@Override 


public void onNext(Integer progress) { 
mArcProgress.setProgress(progress); 


}); 


String destination = "sdcardsoftboy.avi"; 
obserbableDownload("http://archive.blender.org/fileadmin/mov 
ies/softboy.avi", destination) 
. subscribeOn(Schedulers.io()) 
.observeOn(AndroidSchedulers.mainThread() ) 
.subscribe(success -> { 
resetDownloadButton(); 
Intent intent = new Intent (android.content.Intent.AC 
TION VIEW); 
File file = new File(destination); 
intent.setDataAndType(Uri.fromFile(file), "video/avi" 
); 
intent .addFlags(Intent.FLAG ACTIVITY NEW TASK); 
startActivity(intent); 
}, error -> { 
Toast.makeText(getActivity(), "Something went south" 
, TOast.LENGTH_SHORT).show(); 
resetDownloadButton(); 


3); 


我 们 使 用 Butter Knife 的 注解 @onclick 来 绑 定 按钮 的 方法 并 更 新 按钮 信息 和 点 击 
状态 : 我 们 不 想 让 用 户 点 击 多 次 从 而 甬 发 多 次 下 载 事件 。 


然后 ， 我 们 创建 一 个 subscription 来 观察 下 载 进 度 并 相应 的 更 新 进度 条 。 很 明显 ， 我 
们 订阅 在 主线 程 是 因为 进度 条 是 Ul 元 素 。 


obserbableDownload("http://archive.blender.org/fileadmin/movies/ 
softboy.avi", "sdcardsoftboy.avi"; ) 


这 是 一 个 下 载 Observable。 网 络 调用 是 一 个 MO 任务 ， 理 应 使 用 MO 调度 器 。 当 下 载 
完成 ， 就 会 在 onNext() 中 局 动 视 频 播 放 器 ， 并 且 播 放 器 将 会 在 目标 路 径 找 到 下 
载 的 文件 .。 


下 图 展示 了 下 载 进度 和 视频 播放 器 选择 对 话 框 : 


Play on Media Center 
Play on network media player 
Queue on Media Center 


Photos 


DOWNLOADING 


Queue on Xbmc 


VLC 
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这 一 章 中 ， 我 们 学 习 了 如 何 简单 的 将 多 线程 应 用 在 我 们 的 App 中 。RxJava 为 此 提供 
了 极其 实用 的 工具 : 调度 器 。 调 度 器 以 及 不 同 应 用 场景 下 的 优化 方案 一 起 ， 将 我 们 
从 StrictMode 中 的 不 合法 操作 以 及 阻塞 IO 的 方法 中 解放 出 来 。 我 们 现在 可 以 用 
简单 的 ， 响 应 式 的 ， 并 在 整个 App 中 保持 一 致 的 方式 来 访问 本 地 存储 和 网 络 。 


下 一 章 中 ， 我 们 将 会 冒 更 大 的 险 来 创建 一 个 正 儿 和 八 经 的 App， 并 使 用 Square 公司 开 
源 的 REST API 库 Retrofit 来 获取 不 同 的 远程 数据 并 创建 一 个 复杂 的 material design 
UI ° 


5 REST £ 4 24 &-RxJava?r Retrofit 


在 上 一 章 中 ， 我 们 学 习 了 如 何 使 用 调度 器 在 不 同 于 UI 线程 的 线程 上 操作 。 我 们 学 习 
了 如 何 高 效 的 运行 JO 任 务 而 不 用 阻塞 Ul 以 及 如 何 运 行 耗 时 的 计算 任务 而 不 耗损 应 用 
性 能 。 在 最 后 一 章 中 ， 我 们 将 创建 一 个 最 终 版 的 应 用 实例 ， 用 Retrofit 映 射 远程 AP|， 


异步 查询 数据 ， 轻 松 创 造 一 个 丰富 的 Ul 。 


ME E AR 


我 们 将 在 已 有 的 例子 中 创建 一 个 新 的 Activity 。 这 个 Activity 将 通过 
StackExchange API 从 stackoverflow 检 索 出 最 活跃 的 10 位 用 户 。App 使 用 这 些 信息 


= Ie 


来 展示 一 个 包含 用 户头 像 、 姓 名 、 名 望 数 以 及 住址 的 列表 。 对 每 一 位 用 户 ，app 使 
用 OpenWeatherMap APl 来 检索 该 用 户 住址 当地 的 天 气 预报 ， 并 显示 一 个 小 天 气 图 
标 。 基 于 从 StackOverflow 检 索 的 信息 ，app 对 列表 中 的 每 一 位 用 户 提供 一 

个 onClick 事件， 打开 他 们 在 个 人 信息 中 设 定 的 个 人 网 站 或 者 Stack Overflow 的 
个 人 主页 。 


Retrofit 


Retrofit 是 Square 公司 专 为 Android 和 Java 设 计 的 一 个 类 型 安全 的 REST 客 户 端 。 它 
帮助 你 轻松 地 与 任意 REST API 交 互 ， 并 完美 兼容 RxJava : 所 有 的 JSON 响 应 对 象 
都 被 映射 成 原始 的 Java 对 象 ， 并 且 所 有 的 网 络 调用 都 基于 Rxjava Observable 这 些 
对 象 。 


使 用 API 文 档 ， 我 们 可 以 定义 我 们 从 服务 器 接收 的 JSON 响 应 数据 。 为 了 很 容易 的 将 
JSON 响 应 数据 映射 为 我 们 的 Java 人 代码， 我们 将 使 用 sonschema2pojo, 这 个 服务 将 
灵活 地 生成 所 有 与 JSON 响 应 数据 相映 射 的 Java 类 。 


当 我 们 把 所 有 的 Java model 准 备 好 后 ， 我 们 就 可 以 开始 建立 Retrofit。Retrofi 使 用 标 
准 的 Java 接 口 来 映射 API 路 由 。 例 如 例子 中 ， 我 们 将 使 用 来 自 API 的 一 个 路 由 ， 下 面 
是 我 们 Retrofit 的 接口 : 


public interface StackExchangeService { 
@GET("/2.2/users?order=desc&sort=reputation&site=stackoverfl 
ow") 
Observable<User sResponse> getMostPopularSOusers(QQuery ("pag 
esize") int howmany); 


} 


interface 接口 只 包含 一 个 方法 ， 即 getMostPopularSOusers 。 这 个 方法 用 整 
型 howmany 作为 一 个 参数 并 返回 UserResponse 的 Observable。 


当 我 们 有 了 interface ， 我 们 可 以 创建 RestAdapter 类 ， 为 了 更 清楚 的 组 织 我 
们 的 代码 ， 我 们 创建 一 个 SeApiManager 函数 提供 一 种 更 适当 的 方式 来 和 
StackExchange API 交 互 。 


public class SeApiManager { 
private final EE mStackExchangeService; 


public SeApiManager() { 
RestAdapter restAdapter = new RestAdapter .Builder ( ) 
.setEndpoint("https://api.stackexchange.com" ) 
. setLogLevel(RestAdapter .LogLevel.BASIC) 
.build(); 
mStackExchangeService = restAdapter.create(StackExchange 
Service.class); 


} 


public Observable<List<User>> getMostPopularSOusers(int howm 


any) { 
return mStackExchangeService 


.getMostPopularSOusers(howmany ) 
.map(UsersResponse: :getUsers) 

. subscribeOn(Schedulers.io()) 
.observeOn(AndroidSchedulers.mainThread()); 


为 了 简化 例子 ， 我 们 不 再 将 这 个 类 设计 为 它 本 该 设计 成 的 单 例 。 使 用 依赖 注入 解决 
方案 ， 如 Dagger2， 可 使 代码 质量 更 高 。 


创建 RestAdapter 类 ， 需 要 对 客户 端 API 设 置 几 个 重要 的 方面 。 这 个 例子 中 ， 我 
们 设置 了 endpoint 和 log level 。 由 于 这 个 例子 中 URL 只 是 硬 编码 ， 像 这 样 使 
用 外 部 资源 来 存储 数据 很 重要 。 避 免 在 代码 中 硬 编码 字符 串 是 一 个 好 的 实践 。 


Retrofit 把 RestAdapter 类 和 我 们 的 API 接 口 绑 定 在 一 起 后 就 完成 了 创建 。 它 返回 
给 我 们 一 个 对 象 用 来 请 求 API。 我 们 可 以 选择 直接 暴露 这 个 对 象 ， 或 者 以 某 种 封装 
方式 来 限制 对 它 的 访问 。 在 这 个 例子 中 ， 我 们 封装 它 并 只 暴 

露 getMostPopularSOusers 方法 。 这 个 方法 执行 查询 ， 使 用 Retrofit 解 析 JSON 响 

应 数据 。 获 得 用 户 列表 ， 并 返回 给 订阅 者 。 如 你 所 见 ， 使 用 Retrofit、RxJava 和 

Retrolambda， 我 们 几乎 没有 模板 代码 : 它 非常 紧凑 而 且 可 读 性 很 高 。 


een 节理 者 来 提供 一 个 响应 式 的 方法 ， 它 从 远程 API 获 取 数 据 
并 给 |/O 调 度 器 ， 解 析 映 射 最 后 为 我 们 的 消费 者 提供 一 个 简洁 的 用 户 列 表 。 


Retrofit 
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App 4 


我 们 不 使 用 任何 MVC，MVP， 或 者 MVVM 模 式 。 因 为 那 不 是 这 本 书 的 目的 ， 因 此 我 
们 的 Activity 类 将 包含 我 们 需要 创建 和 展示 用 户 列 表 的 所 有 逻辑 。 


al Activity & 


我 们 将 在 onCcreate() 方法 里 创建 SwipeRefreshLayout 和 Recyclerview ; 
我 们 有 一 个 refreshList() 方法 来 处 理 用 户 列表 的 获取 和 展 
示 ， showRefreshing() 方法 来 管理 进度 条 和 Recyclerview 的 显示 。 


我 们 的 refreshList() ABA MT: 


private void refreshList() { 
showRef resh(true); 
mSeApiManager.getMostPopularSOusers(10) 
.subscribe(users -> { 
showRefresh( false); 
mAdapter.updateUsers(users); 
}, error -> { 
App.L.error(error.toString()); 
showRefresh(false); 


3); 


我 们 显示 了 进度 条 ， 从 StackExchange API 管理 器 观测 用 户 列 表 。 一 旦 获取 到 列表 
数据 ， 我 们 开始 展示 它 并 更 新 Adapter 的 内 容 并 让 Recyclerview 显示 为 可 见 。 


创建 RecyclerView Adapter 


` 


我 们 从 REST API 获 取 到 数据 后 ， 我 们 需要 把 它 绑 定 View 上 ， 并 用 一 个 适配器 填充 
列表 。 我 们 的 RecyclerView 适 配器 是 标准 的 。 它 继承 
于 RecyclerView.Adapter 并 指定 它 自己 的 ViewHolder 





public static class ViewHolder extends RecyclerView.ViewHolder { 

@InjectView(R.id.name) TextView name; 
@InjectView(R.id.city) TextView city; 
@InjectView(R.id.reputation) TextView reputation; 
@InjectView(R.id.user image) ImageView user image; 
public ViewHolder (View view) { 

super (view); 

ButterKnife.inject(this, view); 


我 们 一 旦 收 到 来 自 API 管 理 器 的 数据 ， 我 们 可 以 设置 界面 上 所 有 的 标 


Æ : name , city 和 reputation ° 


为 了 展示 用 户 的 头像 ， 我 们 将 使 用 Sergey Tarasevich 5 49 Universal Image 
Loader。 实 践 证 明 ，UIL 是 非常 有 名 的 好 用 的 图 片 管理 库 。 我 们 也 可 以 使 用 Square 
公司 的 Picasso，Glide 或 者 Facebook 公 司 的 Fresco。 取 决 于 你 自己 的 喜好 。 最 关键 
的 是 无 需 重 复 造 轮子 : 库 能 够 方便 开发 者 并 让 他 们 更 快速 实现 目标 。 


在 我 们 的 适配器 中 ， 我 们 可 以 这 样 


@Override 
public void onBindViewHolder(SoAdapter.ViewHolder holder, int po 
sition) { 

User user = mUsers.get(position); 

holder. setUser (user); 


在 ViewHolder ， 我 们 可 以 这 样 : 


public void setUser(User user) { 
name. setText (user .getDisplayName()); 
city.setText(user.getLocation()); 
reputation.setText (String.valueof (user .getReputation())); 


ImageLoader .getInstance().displayImage(user.getProfileImage( 
), user image); 


此 时 ， 我 们 可 以 允许 代码 获得 一 个 用 户 列表 ， 正 如 下 图 所 示 : 


Jon Skeet 
766120 
Reading, United 


Darin Dimitrov 
580887 
Sofia, Bulgaria 


BalusC 
555501 
Amsterdam, 


Hans Passant 
536748 
Madison, WI 





检索 天 气 预 报 


我 们 加 大 难度 ， 将 当地 城市 的 天 气 加 入 列表 中 。OpenWeatherMap 是 一 个 灵活 公 
共 在 线 天 气 API， 我 们 可 以 查询 许多 有 用 的 预报 信息 。 


和 往常 一 样 ， 我 们 将 使 用 Retrofit 映 射 到 API 然 后 通过 RxJava 来 访问 它 。 至 于 
StackExchange API， 我 们 将 创建 interface ， RestAdapter 和 一 个 灵活 的 管 
ES: 


public interface OpenWeatherMapService { 

@GET("data2.5/weather" ) 

Observable<WeatherResponse> getForecastByCity(@Query("q") St 
LNG Cleve 


} 


这 个 方法 用 城市 名 字 作 为 参数 提供 当地 的 预报 信息 。 我 们 像 下 面 这 样 将 接口 
和 RestAdapter 类 绑 定 在 一 起 : 


RestAdapter restAdapter = new RestAdapter.Builder() 
.setEndpoint("http://api.openweathermap.org") 
. setLogLevel(RestAdapter .LogLeve .BASIC ) 
.build( ); 
mOpenweatherMapService = restAdapter.create(OpenweatherMapServic 
e.class); 


像 以 前 一 样 ， 我 们 只 有 两 件 事 需要 立马 去 做 : 设置 API 端 口 和 log 级 别 。 


OpenweatherMapApiManager 类 将 提供 下 面 的 方法 : 


public Observable<WeatherResponse> getForecastByCity(String city) 
{ 
return mOpenWeatherMapService.getForecastByCity(city) 
. subscribeOn(Schedulers.io()) 
.observeOn(AndroidSchedulers.mainThread()); 





现在 ， 我 们 有 了 用 户 列表 ， 我 们 可 以 根据 城市 名 来 查询 OpenVWeatherMap 获 得 天 气 
预报 信息 。 下 一 步 是 修改 我 们 的 ViewHolder 类 来 为 每 位 用 户 展示 相应 的 天 气 图 


标 。 


我 们 使 用 这 些 工 具 方 法 先 验证 用 户主 页 信息 并 获得 一 个 合法 的 城市 名 字 : 


private boolean isCityValid(String location) { 
int separatorPosition = getSeparatorPosition( location); 
return !"" equals(location) && separatorPosition > -1; 


private int getSeparatorPosition(String location) { 


int separatorPosition = -1; 
if (location != null) { 

separatorPosition = location.indexOf(","); 
} 


return separatorPosition; 


private String getCity(String location, int position) | 
if (location != null) { 
return location.substring(0, position); 
+ else { 
return "vs 


借助 一 个 有 效 的 城市 名 ， 我 们 可 以 用 下 面 命令 来 获得 我 们 所 需要 天 气 的 所 有 数据 : 


OpenweatherMapApiManager .getInstance().getForecastByCity(city) 


用 天 气 响 应 的 结果 ， 我 们 可 以 获得 天 气 图 标的 URL : 


getWeatherIconUrl(weatherResponse) ; 


用 图 标 URL， 我 们 可 以 检索 到 图 标本 身 : 


private Observable<Bitmap> loadBitmap(String url) { 
return Observable.create(subscriber -> { 
ImageLoader.getInstance().displayImage(url, city image, n 
ew ImageLoadingListener() { 
@Override 
public void onLoadingStarted(String imageUri, View v 
iew) { 


@Override 
public void onLoadingFailed(String imageUri, View vi 
ew, FailReason failReason) { 
subscriber .onError (failReason.getCause()); 


@Override 
public void onLoadingComplete(String imageUri, View 
view, Bitmap loadedImage) { 
subscriber .onNext ( loadedImage) ; 
subscriber .onCompleted(); 


@Override 

public void onLoadingCancelled(String imageUri, View 
view) { 

subscriber.onError(new Throwable( "Image loading 

cancelled") ); 

} 

}); 
}); 


这 个 loadBitmap() 返回 的 Observable 可 以 链接 前 面 一 个 ， 并 且 最 后 我 们 可 以 为 
这 个 任务 返回 一 个 单独 的 Observable : 


if (isCityValid(location)) { 
String city = getCity(location, separatorPosition); 
OpenwWeatherMapApiManager.getInstance( ).getForecastByCity(cit 
y) 
.filter(response -> response != null) 
.filter(response -> response.getWeather().size() > 0) 
.flatMap(response -> { 
String url = getWeatherIconUrl(response); 
return loadBitmap(url); 
3) 
. subscribeOn(Schedulers.io() ) 
.observeOn(AndroidSchedulers.mainThread() ) 
.subscribe(new Observer<Bitmap>() { 


@Override 
public void onCompleted() { 


} 
@Override 


public void onError(Throwable e) { 
App.L.error(e.toString()); 


@Override 
public void onNext(Bitmap icon) { 
city image.setImageBitmap(icon); 


5H); 


运行 代码 ， 我 们 可 以 在 下 面 列表 中 为 每 个 用 户 获 得 新 的 天 气 图 标 : 


Jon Skeet 
766120 
Reading, United 


Darin Dimitrov 
580887 
Sofia, Bulgaria 


BalusC 
555501 
Amsterdam, 


Hans Passant 
536748 
Madison, WI 





打开 网 站 


使 用 用 户主 页 包 ia 息 ， 我 们 将 会 创建 一 个 onclick 监听 器 来 导航 到 用 户 web 
页 面 ， 如 果 有 的 话 ， 否 则 打开 在 Stack Overflow 上 的 个 人 主页 。 


为 了 实现 它 ， 我 们 简单 实现 Activity 类 的 接口 ， 用 来 在 适配器 触发 Android 
的 onClick 事件 。 


我 们 的 Adapter ViewHolder 指定 这 个 接口 : 


public interface OpenProfileListener { 
public void open(String url); 


Activity 实现 它 
[...] implements SoAdapter.ViewHolder.OpenProfileListener ( [... 


mAdapter.setOpenProfileListener(this); 


[...] 


@Override 

public void open(String url) { 
Intent i = new Intent (Intent.ACTION VIEW); 
i.setData(Uri.parse(url)); 
startActivity(i); 


Activity 收 到 URL 并 用 外 部 Android 浏 览 器 打开 它 。 我 们 的 ViewHolder 负责 在 
用 户 列表 的 每 个 卡片 上 创建 onclickListener 并 检查 我 们 是 打开 Stack Overflow 
用 户主 页 还 是 外 部 个 人 站 : 


mView.setOnClickListener (view -> { 
if (mProfileListener != null) { 
String url = user .getwWebsiteUrl(); 
if (url != null && !url.equals("") && !url.contains("sea 


KEN 


mProfileListener.open(url); 
+ else { 
mProfileListener.open(user.getLink()); 


)}3 


一 旦 我 们 点 击 了 ， 我 们 将 直接 重 定向 到 预期 的 网 站 。 在 Android 上 ， 我 们 可 以 用 
RxAndroid 的 一 种 特殊 形式 (ViewObservable) 以 更 加 响应 式 的 方式 实现 同样 的 结 
Ro 


ViewObservable.clicks(mView) 
.subscribe(onClickEvent -> { 
if (mProfileListener != null) { 
String url = user.getWebsiteUrl(); 
if (url != null && !url.equals("") && !url.contains("sea 
rch")) { 
mProfileListener.open(url); 
+ else { 
mProfileListener.open(user.getLink()); 


3); 


上 面 两 块 代码 片段 是 等 价 的 ， 你 可 以 选择 最 喜欢 的 方式 来 实现 。 


E ZE 


SN 


~ 


我 们 的 旅程 结束 了 。 相 信 你 已 经 准备 好 将 你 的 Java 应 用 带 到 一 个 新 的 代码 质量 水 
平 。 你 可 以 享受 一 个 新 的 编程 模式 并 把 更 流畅 的 思维 方式 应 用 到 日 常 编程 生活 中 。 
RxJava 提 供 了 一 种 以 面向 时 序 的 方式 考虑 数据 的 机 会 : 所 有 事情 都 是 持续 变化 的 ， 
数据 在 更 新 ， 事 件 在 触发 ， 然 后 你 就 可 以 创建 事件 响应 式 的 、 灵 活 的 、 运 行 流畅 的 
App ° 

刚 开 始 切换 到 Poslava Saa ae aen] ， 但 我 们 已 经 体验 到 了 如 何 通过 响应 式 的 

方式 有 效 地 处 理 日 常 问 题 。 现 在 你 可 以 把 你 的 昌 代 码 迁 移 到 RxJava 上 :给 这 些 同 

步 getters 一 种 新 的 响应 式 。 


hee ee 还 有 许多 方法 我 们 还 没有 去 探索 。 有 些 
方法 甚至 还 没有 ， 通 过 RxJava， 你 可 以 创建 你 自己 的 操作 符 并 把 他 们 发 展 地 更 远 


Android 是 一 个 好 玩 的 地 方 ， 但 是 它 也 有 局 限 性 。 作 为 一 个 Android 开 发 者 ， 你 可 以 
用 ee 中 的 许多 。 我 们 用 AndroidScheduler 只 简单 提 了 下 
RxAndroid, 除 了 在 最 后 一 章 ， 你 了 解 了 viewobservable 。RxAndroid 给 了 你 许 
多 : 例如 ， ORTEK > Lifecycleobservable 。 往 后 将 它 发 展 地 更 
长 远 的 任务 就 取决 于 你 了 © 


谨 记 可 观测 序 Æ a 就 像 一 条 河 : 它们 是 流动 的 9 你 可 以 “过 滤 (filter) — 条 河 2 你 可 
以 “转换 "(transform) 一 条 河 ， 你 可 以 将 两 i ， 然 后 依然 畅 流 
如 初 。 最 后 ， 它 就 成 了 你 想 要 的 那 条 河 。 


“Be Water’ my friend” 


--Bruce Lee 


